Provisionar recursos do Dataplex Universal Catalog com o Terraform
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Hashicorp Terraform é uma ferramenta de infraestrutura como código (IaC, na sigla em inglês) que permite provisionar e gerenciar infraestrutura em nuvem. O Terraform fornece plug-ins chamados
provedores, que permitem interagir com provedores de nuvem e outras
APIs. É possível
usar o provedor Terraform para Google Cloud para provisionar e gerenciar
recursos do Google Cloud , incluindo o Dataplex Universal Catalog.
Nesta página, apresentamos o uso do Terraform com o Dataplex Universal Catalog, incluindo uma introdução ao funcionamento do Terraform e alguns recursos para ajudar você a começar a usar o Terraform com o Google Cloud. Você também vai encontrar links para documentos de referência do Terraform para o
Dataplex Universal Catalog, exemplos de código e guias para usar o Terraform no provisionamento de
recursos do Dataplex Universal Catalog.
O Terraform tem uma sintaxe declarativa e orientada pela configuração, que pode ser usada para descrever a infraestrutura que você quer provisionar no projeto Google Cloud . Depois de criar essa configuração em um ou mais arquivos de configuração do Terraform, use a CLI do Terraform para aplicá-la aos recursos do catálogo universal do Dataplex.
As etapas a seguir explicam como o Terraform funciona:
Você descreve a infraestrutura que quer provisionar em um arquivo de configuração do Terraform. Não é preciso escrever código descrevendo como
provisionar a infraestrutura. O Terraform provisiona a infraestrutura para você.
Você executa o comando terraform plan, que avalia sua configuração e gera um plano de execução. É possível analisar o plano e fazer alterações conforme necessário.
Você executará o comando terraform apply, que realiza as seguintes ações:
Ele provisiona sua infraestrutura com base no plano de execução invocando
as APIs correspondentes do Dataplex Universal Catalog em segundo plano.
Ele cria um arquivo de estado do Terraform, que é um arquivo JSON que mapeia os recursos
no arquivo de configuração aos recursos na infraestrutura do mundo real. O Terraform usa esse arquivo para manter um registro do estado mais recente da sua infraestrutura e determinar quando criar, atualizar e destruir recursos.
Ao executar terraform apply, o Terraform usa o mapeamento no
arquivo de estado para comparar a infraestrutura atual com o código e fazer
atualizações conforme necessário:
Se um objeto de recurso for definido no arquivo de configuração, mas não existir no arquivo de estado, o Terraform o criará.
Se há um objeto de recurso no arquivo de estado, mas tem uma configuração
diferente do arquivo de configuração, o Terraform atualiza o
recurso para corresponder ao arquivo de configuração.
Se um objeto de recurso no arquivo de estado corresponder ao seu arquivo de configuração, o Terraform deixará o recurso inalterado.
Recursos do Terraform para o Dataplex Universal Catalog
Recursos são os elementos fundamentais da linguagem do Terraform. Cada
no bloco "resource", que descreve um ou mais objetos de infraestrutura, como
ou instâncias de computação.
A tabela a seguir lista os recursos do Terraform disponíveis para o
Catálogo Universal do Dataplex:
Neste tutorial, explicamos como gerenciar regras de qualidade de dados do Dataplex Universal Catalog como código com o Terraform, o Cloud Build e o GitHub.
Módulos e blueprints do Terraform para o Dataplex Universal Catalog
Os módulos e modelos ajudam a automatizar o provisionamento e o gerenciamento de
recursos do Google Cloud em escala. Um módulo é um conjunto reutilizável de arquivos de configuração do Terraform que cria uma
abstração lógica dos recursos do Terraform. Um blueprint é um pacote de módulos implantáveis e reutilizáveis
e uma política que implementa e documenta uma solução específica.
A tabela a seguir lista módulos e blueprints relacionados ao Dataplex Universal Catalog:
[[["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-08-19 UTC."],[[["\u003cp\u003eTerraform is an infrastructure-as-code tool used to provision and manage cloud infrastructure, including Google Cloud resources like Dataplex, via plugins called providers.\u003c/p\u003e\n"],["\u003cp\u003eTerraform's declarative syntax allows users to describe their desired infrastructure in configuration files, which are then applied using the Terraform CLI.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eterraform apply\u003c/code\u003e command provisions the infrastructure, creates a state file to track resources, and updates infrastructure as needed based on changes to the configuration.\u003c/p\u003e\n"],["\u003cp\u003eTerraform offers a variety of resources for Dataplex, such as \u003ccode\u003egoogle_dataplex_asset\u003c/code\u003e, \u003ccode\u003egoogle_dataplex_lake\u003c/code\u003e, and \u003ccode\u003egoogle_dataplex_zone\u003c/code\u003e, alongside data sources to manage the resources.\u003c/p\u003e\n"],["\u003cp\u003eTerraform provides guides, modules, and blueprints, like the \u003ccode\u003edataplex-auto-data-quality\u003c/code\u003e module, to help automate the provisioning and management of Dataplex resources.\u003c/p\u003e\n"]]],[],null,["# Provision Dataplex Universal Catalog resources with Terraform\n\nHashiCorp Terraform is an infrastructure-as-code (IaC) tool that lets you\nprovision and manage cloud infrastructure. Terraform provides plugins called\n*providers* that let you interact with cloud providers and other APIs. You can\nuse the *Terraform provider for Google Cloud* to provision and manage\nGoogle Cloud resources, including Dataplex Universal Catalog.\n\nThis page introduces you to using Terraform with Dataplex Universal Catalog, including an\nintroduction to how Terraform works and some resources to help you get started using\nTerraform with Google Cloud. You'll also find links to Terraform reference docs for\nDataplex Universal Catalog, code examples, and guides for using Terraform to provision\nDataplex Universal Catalog resources.\n\nFor instructions on how to get started with Terraform for Google Cloud, see\n[Install and configure Terraform](/docs/terraform/install-configure-terraform) or the\n[Terraform for Google Cloud quickstart](/docs/terraform/create-vm-instance).\n\nHow Terraform works\n-------------------\n\nTerraform has a declarative and configuration-oriented syntax, which you can\nuse to describe the infrastructure that you want to provision in your\nGoogle Cloud project. After you author this configuration in one or more\nTerraform configuration files, you can use the Terraform CLI to apply this\nconfiguration to your Dataplex Universal Catalog resources.\n\nThe following steps explain how Terraform works:\n\n1. You describe the infrastructure you want to provision in a *Terraform\n configuration file*. You don't need to write code describing how to provision the infrastructure. Terraform provisions the infrastructure for you.\n2. You run the `terraform plan` command, which evaluates your configuration and generates an execution plan. You can review the plan and make changes as needed.\n3. You run the `terraform apply` command, which performs the following\n actions:\n\n 1. It provisions your infrastructure based on your execution plan by invoking the corresponding Dataplex Universal Catalog APIs in the background.\n 2. It creates a *Terraform state file*, which is a JSON file that maps the resources in your configuration file to the resources in the real-world infrastructure. Terraform uses this file to keep a record of the most recent state of your infrastructure, and to determine when to create, update, and destroy resources.\n 3. When you run `terraform apply`, Terraform uses the mapping in\n the state file to compare the existing infrastructure to the code, and make\n updates as necessary:\n\n - If a resource object is defined in the configuration file, but doesn't exist in the state file, Terraform creates it.\n - If a resource object exists in the state file, but has a different configuration from your configuration file, Terraform updates the resource to match your configuration file.\n - If a resource object in the state file matches your configuration file, Terraform leaves the resource unchanged.\n\nTerraform resources for Dataplex Universal Catalog\n--------------------------------------------------\n\n*Resources* are the fundamental elements in the Terraform language. Each\nresource block describes one or more infrastructure objects, such as virtual\nnetworks or compute instances.\n\nThe following table lists the Terraform resources available for\nDataplex Universal Catalog:\n\n\n\u003cbr /\u003e\n\nTerraform-based guides for Dataplex Universal Catalog\n-----------------------------------------------------\n\nThe following table lists Terraform-based how-to guides and tutorials for\nDataplex Universal Catalog:\n\n\n\u003cbr /\u003e\n\nTerraform modules and blueprints for Dataplex Universal Catalog\n---------------------------------------------------------------\n\nModules and blueprints help you automate provisioning and managing of\nGoogle Cloud resources at scale. A *module* is a\nreusable set of Terraform configuration files that creates a logical abstraction\nof Terraform resources. A *blueprint* is a package of deployable and reusable\nmodules, and a policy that implements and documents a specific solution.\n\nThe following table lists modules and blueprints related to\nDataplex Universal Catalog:\n\n\n\u003cbr /\u003e\n\nWhat's next\n-----------\n\n- [Terraform code samples for Dataplex Universal Catalog](/docs/samples?language=terraform)\n- [Terraform on Google Cloud documentation](/docs/terraform)\n- [Google Cloud provider documentation in HashiCorp](https://registry.terraform.io/providers/hashicorp/google/latest/docs)\n- [Infrastructure as code for Google Cloud](/docs/terraform/iac-overview)"]]
