Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Para usar o Data Catalog, você precisa
ativar a API Data Catalog
em um Google Cloud
projeto
que contenha os recursos que você vai criar no Data Catalog ou
acessar em outros Google Cloud sistemas com a API. Nós nos referimos a este projeto como o projeto de recurso do Data Catalog.
No caso comum, se você tiver apenas um projeto, basta ativar a API Data Catalog nele para acessar todos os recursos que ele contém.
O guia de início rápido do Data Catalog
é um exemplo de criação de um projeto com a API
Data Catalog ativada e contém uma tabela do BigQuery que você acessa, bem como uma
tag do Data Catalog. modelo e tag.
Como usar modelos de tag em vários projetos
Tudo no Google Cloud reside em um projeto, incluindo seus modelos de tag. No entanto, você pode usar modelos de tags de um projeto para criar tags em outro projeto se autorizar o outro a usar os modelos.
Para fazer isso, use os papéis de IAM TagTemplate Owner, Creator, User e Viewer.
Por exemplo: se o projeto A conceder o papel TagTemplate User a uma conta de
serviço do projeto B, isso permitirá que o projeto B crie tags usando os
modelos. O Projeto A também pode autorizar a mesma conta de serviço a modificar as
tags criadas usando o papel Tag Editor.
Se o projeto A não autorizar o projeto B, ele não poderá incluir tags nos próprios recursos de
dados usando os modelos de tag do projeto A. Ele precisará criar os próprios modelos.
Prática recomendada: crie modelos em um projeto central
se eles forem relevantes para mais de um projeto. Além disso, sua equipe de governança de dados
precisa ser proprietária dos modelos de tags compartilhadas e mantê-los em nome da
organização.
Como identificar o projeto de recursos do Data Catalog
A tabela a seguir lista as APIs do Data Catalog e os projetos de recursos associados em que a API do Data Catalog precisa estar ativada.
Se o X-Goog-User-Project for especificado no cabeçalho HTTP/gRPC, ative também a API Data Catalog no projeto do usuário para ativar cota e faturamento em vez do X-Goog-User-Project da conta de serviço.
Exceções: veja createTag/updateTag/deleteTag na próxima linha.
createTag/updateTag/deleteTag
projeto de contêiner do modelo de tag
Como a Data Catalog API foi ativada no projeto do contêiner do modelo de tag quando o modelo foi criado, nenhuma outra ação é necessária para chamar essas APIs. Observação: o projeto identificado pelo parâmetro parent para a tag e o modelo de tag usado para criar a tag deve ser da mesma organização.
Observações:
service account project: o projeto no qual você gerou credenciais da conta de serviço para autenticar o código do aplicativo.
resource parameter: o parâmetro passado na solicitação de API que identifica o recurso associado à solicitação (por exemplo, veja project-id no parâmetro tagTemplates.createparent).
[[["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-02-01 UTC."],[[["\u003cp\u003eThe Data Catalog API must be enabled in a Google Cloud project, referred to as the "resource project," to create resources in Data Catalog or access them in other Google Cloud systems.\u003c/p\u003e\n"],["\u003cp\u003eTag templates, although created within a specific project, can be used to create tags in other projects if the appropriate IAM roles (\u003ccode\u003eTagTemplate Owner\u003c/code\u003e, \u003ccode\u003eCreator\u003c/code\u003e, \u003ccode\u003eUser\u003c/code\u003e, and \u003ccode\u003eViewer\u003c/code\u003e) are granted.\u003c/p\u003e\n"],["\u003cp\u003eThe project hosting the tag template is responsible for billing, even if the tags are utilized by other projects.\u003c/p\u003e\n"],["\u003cp\u003eFor optimal management, it's a best practice to create tag templates in a centralized project if they're intended for use across multiple projects, and a data governance team should manage them.\u003c/p\u003e\n"],["\u003cp\u003eThe necessary project in which the Data Catalog API must be enabled varies according to which Data Catalog APIs are being utilized, such as \u003ccode\u003eget/lookup/search\u003c/code\u003e vs.\u003ccode\u003ecreate/update/delete\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Data Catalog resource projects\n\nTo use Data Catalog, you must\n[enable the Data Catalog API](/apis/docs/enable-disable-apis#enable_an_api)\nin a Google Cloud\n[project](/resource-manager/docs/cloud-platform-resource-hierarchy#projects)\nthat contains the resources you will create in Data Catalog or\naccess in other Google Cloud systems with the API. We refer\nto this project as the Data Catalog \"resource project\".\n\nIn the common case, if you have only one project, you only need to enable\nthe Data Catalog API in it to access all the resources it contains.\nThe [Data Catalog quickstart](/data-catalog/docs/quickstarts/quickstart-search-tag)\nis an example of the creation of a project that has the Data Catalog\nAPI enabled and contains a BigQuery table you access as well as a\nData Catalog tag template and tag.\n\n### Using tag templates in multiple projects\n\nEverything in Google Cloud lives in a project, including your tag\ntemplates. However, you can use tag templates from one project to create tags in\nanother if you authorize the other project to use the templates.\nTo do this, use the `TagTemplate Owner`, `Creator`, `User`, and `Viewer` IAM\nroles.\n\nFor example: If project A grants the `TagTemplate User` role to a service\naccount owned by project B, this authorizes project B to create tags using its\ntemplates. Project A can also authorize the same service account to modify the\ncreated tags using the `Tag Editor` role.\n\nIf project A does not authorize project B, project B cannot tag its own data\nresources using project A's tag templates---it must create its own templates.\n| **Important:** The project that hosts your tag template is billed for tags created from it, even if they are used by other projects.\n\n**Best practice:** Create templates in a central project\nif they are relevant to more than one project. Also, your data governance team\nshould own the shared tag templates and maintain them on behalf of the\norganization.\n\n### Identifying the Data Catalog resource project\n\nThe following table lists Data Catalog APIs and the\nassociated resource project(s) where Data Catalog\nAPI must be enabled.\n\n**Notes:**\n\n- `service account project`: the project in which you have generated\n [service account credentials](/iam/docs/service-account-overview#what-are-service-accounts)\n to authenticate your application code.\n\n- `resource parameter`: the parameter passed in the API request that\n identifies the resource associated with the request (for example, see `project-id` in the\n [tagTemplates.create](/data-catalog/docs/reference/rest/v1beta1/projects.locations.tagTemplates/create)\n `parent` parameter).\n\nWhat's next\n-----------\n\n- Follow [Getting started with Data Catalog](/data-catalog/docs/quickstarts/quickstart-search-tag)."]]
