Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Nesta página, explicamos os recursos de administração que o
Cloud Data Fusion Studio oferece para gerenciar configurações.
O Cloud Data Fusion segue uma hierarquia em que cada instância pode ter
vários namespaces. No Cloud Data Fusion Studio, os administradores
podem gerenciar todos os namespaces de forma centralizada ou individualmente.
O Cloud Data Fusion Studio oferece os seguintes controles de sistema e namespace.
Administração do sistema
Clique em Administrador do sistema no Cloud Data Fusion Studio para mostrar as guias a seguir:
Guia Gerenciamento: confira o status de integridade de vários serviços do Cloud Data Fusion. Também é possível conferir os registros de cada um dos
serviços.
Na guia Configuração, crie, visualize e edite os seguintes controles:
Perfis de computação do sistema. Os perfis de computação indicam qual provisionador usar ao criar um cluster para a execução do pipeline e aplicar as configurações associadas.
Os provisionadores são responsáveis por criar, inicializar e destruir o
ambiente de nuvem em que os pipelines são executados. Cada provisionador expõe um conjunto de
configurações que são usadas para controlar o tipo de cluster que é criado
e excluído. Diferentes provisionadores criam diferentes tipos de clusters.
Cada perfil de computação tem um escopo: sistema ou usuário. É possível usar um perfil de computação do sistema para qualquer namespace abaixo dele. Os perfis de computação do usuário existem em um
namespace, e somente pipelines nesse namespace podem usar os perfis de computação
do usuário.
Na guia Configurations do administrador do sistema, é possível criar um perfil de computação do sistema que é aplicado a todos os namespaces. O Cloud Data Fusion
atribui um perfil de computação padrão.
Ao criar um perfil de computação, você seleciona o provisionador, que o perfil
usa para criar e configurar os detalhes do ambiente de execução da nuvem.
Preferências do sistema
As preferências são configurações predefinidas que se aplicam a vários níveis do Cloud Data Fusion, incluindo o próprio sistema, namespaces, aplicativos (que contêm pipelines) e programas individuais nos pipelines. As preferências
oferecem uma maneira de definir valores padrão para configurações usadas com frequência. Esses
padrões podem ser herdados por pipelines e programas em níveis mais baixos, reduzindo
tarefas de configuração repetitivas. Para mais informações, consulte Gerenciar macros,
preferências e argumentos de execução.
Ação de chamada HTTP
A ação de chamada HTTP na página Administrador do sistema permite interagir com a API do Cloud Data Fusion ou com outras APIs de serviço Google Cloud diretamente na interface do Studio. No entanto, para
criar pipelines de processamento de dados com origens externas, use o
plug-in HTTP e o executor de chamadas HTTP nos pipelines para uma solução mais
completa. Ela é um pouco diferente da ação de chamada HTTP, mas os
conceitos subjacentes são semelhantes.
Configurações e casos de uso
A ação de chamada HTTP é usada principalmente para tarefas administrativas ou
fins de configuração no Cloud Data Fusion. Ele permite interagir com a API Cloud Data Fusion ou outros serviços Google Cloud que expõem uma API HTTP diretamente do Cloud Data Fusion Studio.
Configurações
É possível definir os seguintes detalhes para uma chamada HTTP:
URL: o endpoint de destino do serviço da Web que você quer
chamar.
Método: o método HTTP a ser usado, como GET,
POST ou PUT.
Opcional: Cabeçalhos: qualquer cabeçalho personalizado necessário para a
solicitação.
Opcional: Body: dados a serem enviados no corpo da solicitação, como
para chamadas POST e PUT.
Em seguida, execute a chamada HTTP definida e confira a resposta do serviço da Web no Cloud Data Fusion Studio.
Casos de uso
Teste as chamadas da API Cloud Data Fusion. É possível usar a ação de chamada HTTP para testar ou explorar as funcionalidades da API Cloud Data Fusion diretamente na interface da Web. Essa ação pode ser útil para
entender o comportamento da API ou resolver possíveis problemas.
Gerenciar namespaces (avançado). Embora haja uma interface dedicada para o gerenciamento de namespaces, a ação de chamada HTTP pode ser usada para tarefas avançadas, fazendo chamadas diretamente para a API Cloud Data Fusion para criação, exclusão ou configuração de namespaces.
Interagir com outros serviços Google Cloud (limitado).
Se outros Google Cloud serviços que você usa tiverem uma API HTTP documentada
publicamente, use a ação de chamada HTTP para interagir com esses
serviços, embora esse seja um caso de uso incomum.
Considerações importantes
Segurança: tenha cuidado ao usar a ação de chamada HTTP,
principalmente com dados sensíveis ou chamadas da API Cloud Data Fusion que
possam afetar seu ambiente. Entenda as
implicações de cada chamada de API antes de executá-la.
Limitações: a ação de chamada HTTP é usada principalmente para
tarefas administrativas e fins de teste. Ele não foi projetado para criar pipelines de processamento de dados complexos que envolvam a manipulação de dados no Cloud Data Fusion.
Alternativa para pipelines: para integrar fontes ou serviços de dados externos aos pipelines de dados, use o plug-in HTTP e o executor de chamadas HTTP associado nas definições do pipeline. Isso
oferece uma maneira mais robusta e controlada de gerenciar interações HTTP
nos fluxos de trabalho de processamento de dados.
Administração de namespace
Clique em Administrador do namespace no Cloud Data Fusion Studio para gerenciar as configurações de um namespace específico. Para cada namespace, é possível definir os seguintes aspectos:
Perfis de computação: os perfis configurados no Administrador do namespace são perfis de computação de usuário. Somente pipelines nesse namespace podem usar esses perfis de computação do usuário. Para mais informações, consulte Gerenciar perfis de computação.
Preferências: as preferências definidas no nível do namespace são aplicáveis ao
namespace, aos aplicativos (que contêm pipelines) e aos programas
individuais nos pipelines. Para mais informações, consulte Gerenciar macros,
preferências e argumentos de execução.
Conexões: o Cloud Data Fusion permite reutilizar conexões com
origens e coletores em pipelines de dados. É possível adicionar conexões na página "Administrador de namespace". Para mais informações, consulte
Criar e gerenciar conexões.
Drivers: alguns plug-ins no Cloud Data Fusion exigem que um driver JDBC seja adicionado ao namespace. Por exemplo, antes de executar um pipeline com um
plug-in de origem de lote do MySQL, adicione o driver MySQL compatível ao
espaço de nome. É possível fazer upload ou remover drivers JDBC para um namespace na página de administrador do namespace ou diretamente do Hub. Para mais informações, consulte
Drivers de plug-in.
Gerenciamento de controle de origem: para gerenciar de maneira eficiente o processo de desenvolvimento
de pipelines implantados, o Gerenciamento de controle de origem permite conectar um
espaço de nomes ao repositório do sistema de controle de origem. Para mais
informações, consulte Gerenciar pipelines usando o gerenciamento de controle de origem.
Para um melhor isolamento de dados, é possível associar uma conta de serviço personalizada do Identity and Access Management (IAM, na sigla em inglês) (conhecida como uma conta de serviço por namespace) a cada namespace. A conta de serviço personalizada do IAM, que pode ser diferente para diferentes namespaces, permite controlar o acesso a recursos Google Cloud entre namespaces para operações de tempo de design do pipeline no Cloud Data Fusion, como visualização do pipeline, Wrangler e validação do pipeline. Para mais informações, consulte
Controle de acesso com a conta de serviço do namespace.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-04 UTC."],[[["\u003cp\u003eCloud Data Fusion Studio enables administrators to manage configurations across multiple namespaces, either centrally or individually, offering both system and namespace-specific controls.\u003c/p\u003e\n"],["\u003cp\u003eSystem administrators can manage compute profiles, define system-wide preferences, and view the health status of Cloud Data Fusion services through the Management and Configuration tabs.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP call action allows for direct interaction with Cloud Data Fusion's API and other Google Cloud service APIs for administrative tasks, but the HTTP plugin is recommended for building pipelines with external data sources.\u003c/p\u003e\n"],["\u003cp\u003eNamespace administrators can configure user compute profiles, preferences, connections, drivers, source control management, and service accounts, each specific to the namespace.\u003c/p\u003e\n"],["\u003cp\u003eCompute profiles determine which provisioner is used to create the cloud environment for pipelines, with system profiles applying to all namespaces and user profiles confined to a single namespace.\u003c/p\u003e\n"]]],[],null,["# Manage Studio administration\n\nThis page explains the administration capabilities that the Cloud Data Fusion Studio provides to manage configurations. Cloud Data Fusion follows a hierarchy, where each instance can have multiple [namespaces](/data-fusion/docs/how-to/control-access-in-namespace). From the Cloud Data Fusion Studio, administrators can centrally manage all namespaces, or manage them individually. Cloud Data Fusion Studio provides the following system and namespace controls.\n\n\u003cbr /\u003e\n\nSystem administration\n---------------------\n\nClicking **System admin** in the Cloud Data Fusion Studio displays the\nfollowing tabs:\n\n- The **Management** tab: view the health status of various Cloud Data Fusion services. You can also view logs for each of the services.\n- The **Configuration** tab: create, view, and edit the following controls:\n\n - **Namespaces** . For more information, see [Access control with a namespace service account](/data-fusion/docs/how-to/control-access-in-namespace).\n - **System compute profiles** . [Compute profiles](/data-fusion/docs/concepts/overview#concepts) indicate which provisioner to use when creating a cluster for pipeline execution and applying the associated configurations.\n\n*Provisioners* are responsible for creating, initializing, and destroying the\ncloud environment that pipelines run in. Each provisioner exposes a set of\nconfigurations that are used to control what type of cluster is created\nand deleted. Different provisioners create different types of clusters.\n| **Note:** The Dataproc provisioner is recommended.\n\nEach compute profile has a scope: system or user. You can use a system compute\nprofile for any namespaces under it. User compute profiles exist within a\nnamespace, and only pipelines in that namespace can use the user compute\nprofiles.\n\nOn the system administrator **Configurations** tab, you can create a system\ncompute profile that's applied to all the namespaces. Cloud Data Fusion\nassigns a default compute profile.\n\nWhen you create a compute profile, you select the provisioner, which the profile\nuses to create and configure the cloud runtime details.\n| **Note:** In general, provisioner configurations can be overridden at runtime. For more information, see [Manage compute profiles](/data-fusion/docs/how-to/manage-compute-profiles).\n\nSystem preferences\n------------------\n\nPreferences are predefined configurations that apply at various levels within\nCloud Data Fusion, including the system itself, namespaces, applications\n(which contain pipelines), and individual programs within pipelines. Preferences\nprovide a way to set default values for commonly used configurations. These\ndefaults can be inherited by pipelines and programs at lower levels, reducing\nrepetitive configuration tasks. For more information, see [Manage macros,\npreferences, and runtime arguments](/data-fusion/docs/how-to/manage-macros-prefs-and-runtime-args).\n\n### HTTP call action\n\nThe HTTP call action on the **System admin** page lets you interact with\nCloud Data Fusion's own API, or potentially other Google Cloud service\nAPIs, directly from the Cloud Data Fusion Studio interface. However, for\nbuilding data processing pipelines with external data sources, instead use the\nHTTP plugin and its HTTP call Executor within your pipelines for a more\ncomprehensive solution. It differs slightly from the HTTP call action, but the\nunderlying concepts are alike. \n\n#### Configurations and use cases\n\nThe HTTP call action is primarily used for administrative tasks or\nconfiguration purposes within Cloud Data Fusion. It lets you interact\nwith the Cloud Data Fusion API or other Google Cloud services\nthat expose an HTTP API, directly from the Cloud Data Fusion\nStudio.\n\n##### Configurations\n\nYou can define the following details for an HTTP call:\n\n- **URL**: the target endpoint of the web service you want to call.\n- **Method** : the HTTP method to use, such as `GET`, `POST`, or `PUT`.\n- Optional: **Headers**: any custom headers required for the request.\n- Optional: **Body** : data to be sent in the request body, such as for `POST` and `PUT` calls.\n\nYou can then execute the defined HTTP call and view the response from the\nweb service within the Cloud Data Fusion Studio.\n\n##### Use cases\n\n- **Test Cloud Data Fusion API calls.** You can use the HTTP call action to test or explore Cloud Data Fusion API functionalities directly from the web interface. This action can be helpful for understanding API behavior or troubleshooting potential issues.\n- **Manage namespaces (advanced).** While there's a dedicated UI for namespace management, the HTTP call action can be used for advanced tasks by directly making calls to the Cloud Data Fusion API for namespace creation, deletion, or configuration.\n- **Interacting with other Google Cloud services (limited).** If other Google Cloud services you use have a publicly documented HTTP API, you can use the HTTP call action to interact with those services, though this is an uncommon use case.\n\n##### Important considerations\n\n- **Security**: be cautious when using the HTTP call action, especially with sensitive data or Cloud Data Fusion API calls that could impact your environment. Be sure that you understand the implications of each API call before executing it.\n- **Limitations**: the HTTP call action is primarily for administrative tasks and testing purposes. It's not designed for building complex data processing pipelines that involve data manipulation within Cloud Data Fusion.\n- **Alternative for pipelines**: for integrating external data sources or services into your data pipelines, use the HTTP plugin and its associated HTTP call executor within your pipeline definitions. This provides a more robust and controlled way to manage HTTP interactions within your data processing workflows.\n\nNamespace administration\n------------------------\n\nClicking **Namespace admin** in the Cloud Data Fusion Studio lets you\nmanage the configurations for the specific namespace. For each namespace, you\ncan define the following aspects:\n\n- **Compute profiles** : the profiles set up in **Namespace admin** are *user* compute profiles. Only pipelines in that namespace can use these user compute profiles. For more information, see [Manage compute profiles](/data-fusion/docs/how-to/manage-compute-profiles).\n- **Preferences** : preferences defined at namespace level are applicable to the namespace, applications (which contain pipelines), and individual programs within pipelines. For more information, see [Manage macros,\n preferences, and runtime arguments](/data-fusion/docs/how-to/manage-macros-prefs-and-runtime-args).\n- **Connections** : Cloud Data Fusion lets you reuse connections to sources and sinks in data pipelines. You can add connections in the Namespace Admin page. For more information, see [Create and manage connections](/data-fusion/docs/how-to/managing-connections).\n- **Drivers** : some plugins in Cloud Data Fusion require a JDBC driver to be added to the namespace. For example, before you can run a pipeline with a MySQL batch source plugin, you must add the supported MySQL driver to the namespace. You can upload or remove JDBC drivers to a namespace from the Namespace Admin page, or directly from the Hub. For more information, see [Plugin drivers](/data-fusion/docs/how-to/source-control-management).\n- **Source Control Management** : to efficiently manage the development process of deployed pipelines, Source Control Management lets you connect a namespace with the repository of your source control system. For more information, see [Manage pipelines using Source Control Management](/data-fusion/docs/how-to/source-control-management).\n- **Service account** : to control access to Google Cloud resources, namespaces in Cloud Data Fusion use the [Cloud Data Fusion API Service Agent](/iam/docs/understanding-roles#datafusion.serviceAgent) by default.\n\nFor better data isolation, you can associate a customized\nIdentity and Access Management (IAM) service account (known as a Per Namespace\nService Account) with each namespace. The customized IAM service\naccount, which can be different for different namespaces, lets you control\naccess to Google Cloud resources between namespaces for pipeline\ndesign-time operations in Cloud Data Fusion, such as pipeline preview,\nWrangler, and pipeline validation. For more information, see\n[Access control with namespace service account](/data-fusion/docs/how-to/control-access-in-namespace).\n\nWhat's next\n-----------\n\n- Learn more about [compute profiles](/data-fusion/docs/how-to/manage-compute-profiles).\n- Learn more about [macros, preferences, and runtime arguments](/data-fusion/docs/how-to/manage-macros-prefs-and-runtime-args)."]]
