Visualização de lista de linhagens (pré-lançamento): mostra
informações detalhadas de linhagem para recursos em uma única tabela que inclui
informações de linhagem para recursos com muitas conexões. Para mais informações, consulte Visualização de lista de linhagem.
Também é possível recuperar informações de linhagem da API Data Lineage na
forma de dados JSON.
A linhagem é capturada em vários projetos. Quando você acessa a linhagem gerada
em vários projetos, é possível conferir as informações agregadas em qualquer
um dos projetos relevantes.
Papéis e permissões
Para conferir as informações de linhagem, peça ao administrador para conceder a você as funções de leitor, conforme descrito em Funções predefinidas para a linhagem de dados.
Você precisa ter acesso ao projeto em que você visualiza a linhagem e aos
projetos em que a linhagem é registrada.
O Dataplex Universal Catalog rastreia as informações de linhagem automaticamente quando você ativa
a API Data Lineage.
Você não precisa de funções de administrador ou editor para capturar a linhagem dos seus recursos de dados.
Ative a linhagem de dados para começar a rastrear automaticamente as informações de linhagem para
sistemas com suporte.
É necessário ativar a API Data Lineage no projeto em que você visualiza a linhagem e nos projetos em que a linhagem é gravada. Para mais informações, consulte
Tipos de projeto.
Para capturar informações de linhagem, faça o seguinte:
No console Google Cloud , na página Seletor de projetos, selecione o projeto em que você quer registrar a linhagem.
Na página de detalhes da entrada, selecione a guia Linhagem.
Para conferir o gráfico de linhagem, clique em Graph.
Selecione os botões de processo ou de fonte de dados para mostrar o painel de detalhes.
Para conferir informações de linhagem upstream ou downstream de um recurso, clique em
addExpandir.
Para conferir a linhagem na visualização em lista, clique em List.
Para conferir a visualização do caminho de linhagem, clique em Listar e selecione o
recurso de destino na tabela de resultados. No painel de detalhes, clique em Alvo e em Visualizar linhagem.
Conferir a linhagem no BigQuery
É possível conferir informações sobre a linhagem de dados na interface da Web do BigQuery.
Para conferir a linhagem, siga estas instruções:
No console Google Cloud , acesse a página BigQuery.
Abra a tabela para a qual você quer conferir a linhagem de dados.
Clique na guia Linhagem.
Para conferir o gráfico de linhagem, clique em Graph.
Selecione os botões de processo ou de fonte de dados para mostrar o painel de detalhes.
Para conferir informações de linhagem upstream ou downstream de um recurso, clique em
addExpandir.
Para conferir a linhagem na visualização em lista, clique em List.
Para conferir a visualização do caminho de linhagem, clique em Listar e selecione o
recurso de destino na tabela de resultados. No painel de detalhes, clique em Alvo e em Visualizar linhagem.
Conferir a linhagem na Vertex AI
Sistemas como o Vertex AI Pipelines geram dados de linhagem para
modelos e conjuntos de dados da Vertex AI. É possível conferir informações de linhagem de dados na interface da Web da interface da Vertex AI.
Conferir a linhagem de um conjunto de dados gerenciado na Vertex AI
Para conferir a linhagem de um conjunto de dados, siga estas instruções:
No Google Cloud console, acesse a página Conjuntos de dados.
Clique no conjunto de dados para ver a linhagem de dados.
Clique na guia Linhagem.
Para conferir o gráfico de linhagem, clique em Graph.
Selecione os botões de processo ou de fonte de dados para mostrar o painel de detalhes.
Para conferir informações de linhagem upstream ou downstream de um recurso, clique em
addExpandir.
Para conferir a linhagem na visualização em lista, clique em List.
Para conferir a visualização do caminho de linhagem, clique em Listar e selecione o
recurso de destino na tabela de resultados. No painel de detalhes, clique em Alvo e em Visualizar linhagem.
Conferir a linhagem de um modelo na Vertex AI
Para conferir a linhagem de um modelo, siga estas instruções:
No Google Cloud console, acesse a página Registro de modelos.
Para conferir o gráfico de linhagem, clique em Graph.
Selecione os botões de processo ou de fonte de dados para mostrar o painel de detalhes.
Para conferir informações de linhagem upstream ou downstream de um recurso, clique em
addExpandir.
Para conferir a linhagem na visualização em lista, clique em List.
Para conferir a visualização do caminho de linhagem, clique em Listar e selecione o
recurso de destino na tabela de resultados. No painel de detalhes, clique em Alvo e em Visualizar linhagem.
[[["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-21 UTC."],[[["\u003cp\u003eData lineage reveals the relationships between project resources and the processes that created them, and it's available through various views like Lineage graph, Lineage path visualization, and Lineage list view.\u003c/p\u003e\n"],["\u003cp\u003eLineage information can be accessed in the Google Cloud console, and specifically in Dataplex, BigQuery, and Vertex AI web interfaces, with instructions provided for each.\u003c/p\u003e\n"],["\u003cp\u003eTo begin capturing lineage data, the Data Lineage API must be enabled in all projects involved, both where data is recorded and where it's viewed, and it can take anywhere between 3 and 24 hours for data lineage to display.\u003c/p\u003e\n"],["\u003cp\u003eViewing lineage requires appropriate viewer roles in all relevant projects, and Dataplex will automatically track this information once the Data Lineage API is enabled.\u003c/p\u003e\n"],["\u003cp\u003eLineage information is captured across projects, allowing you to view aggregated data within any of the projects that are relevant.\u003c/p\u003e\n"]]],[],null,["# Use data lineage with Google Cloud systems\n\nData lineage displays the relations between your project's\nresources and the processes that created them.\n\nYou can view data lineage information in the Google Cloud console in\nthe following forms:\n\n- **Lineage graph** : shows the lineage that is upstream or downstream of a single root entry. For more information, see [Lineage graph](/dataplex/docs/about-data-lineage#lineage-feature-graph).\n- **Lineage path visualization** ([Preview](/products#product-launch-stages)): shows the lineage links between two selected resources. For more information, see [Lineage path visualization](/dataplex/docs/about-data-lineage#visualize-path).\n- **Lineage list view** ([Preview](/products#product-launch-stages)): shows detailed lineage information for resources in a single table that includes lineage information for resources with many connections. For more information, see [Lineage list view](/dataplex/docs/about-data-lineage#lineage-list-view).\n\n| **Tip:** If this is your first time working with data lineage, consider following the quickstart: [Track data lineage for a BigQuery table](/dataplex/docs/track-lineage-quickstart).\n\nYou can also retrieve lineage information from the Data Lineage API in the\nform of JSON data.\n\nLineage is captured across projects. When you view lineage that is generated\nfrom multiple projects, you can view the aggregated lineage information in any\nof the relevant projects.\n| **Caution:** Data lineage is enabled on a per-project basis, not a per-service basis. After you enable the Data Lineage API, lineage information is automatically reported for multiple Google Cloud services in the project, depending on their product-level lineage control. For more details, see [Data lineage considerations](/dataplex/docs/lineage-considerations).\n\nDepending on the volume of data being processed, it takes time for\ndata lineage to display a graph. For most jobs it takes three hours,\nand for some jobs it can take up to 24 hours.\n\nRoles and permissions\n---------------------\n\nTo view lineage information, ask your administrator to grant you viewer roles\nas described in\n[Predefined roles for data lineage](/dataplex/docs/iam-roles#lineage-roles).\nYou must have access in both the project where you view lineage, and the\nprojects in which lineage is recorded.\n\nDataplex Universal Catalog tracks lineage information automatically when you enable\nthe [Data Lineage API](/dataplex/docs/reference/data-lineage/rest).\nYou don't need any administrator or editor roles to capture lineage for your\ndata assets.\n\nFor more information about granting roles,\nsee [Manage access](/iam/docs/granting-changing-revoking-access).\nYou can assign a role at a higher folder or organization level (see\n[Grant or revoke a single role](/iam/docs/granting-changing-revoking-access#single-role)).\n\nEnable data lineage\n-------------------\n\nEnable data lineage to begin automatically tracking lineage\ninformation for\n[supported systems](/dataplex/docs/about-data-lineage#lineage-supported-systems).\nYou must enable the Data Lineage API in both the project where you view\nlineage, and the projects in which lineage is recorded. For more information, see\n[Project types](/dataplex/docs/troubleshooting-lineage#project_types).\n\n1. To capture lineage information, do the following:\n\n 1. In the Google Cloud console, on the **Project selector**\n page, select the project in which you want to record lineage.\n\n [Go to Project selector](https://console.cloud.google.com/projectselector2/home/dashboard)\n 2. Enable the Data Lineage API.\n\n [Enable the Data Lineage API](https://console.cloud.google.com/apis/enableflow?apiid=datalineage.googleapis.com)\n 3. Repeat the previous steps for each project in which you want to record lineage.\n2. In the project where you view lineage, enable the Data Lineage API\n and the Dataplex API.\n\n [Enable the APIs](https://console.cloud.google.com/apis/enableflow?apiid=datalineage.googleapis.com,dataplex.googleapis.com)\n\nView lineage in Dataplex Universal Catalog\n------------------------------------------\n\nYou can view data lineage information in the Dataplex Universal Catalog web interface.\n\nTo view the lineage, follow these instructions:\n\n1. In the Google Cloud console, go to the Dataplex Universal Catalog **Search** page.\n\n\n [Go to Search](https://console.cloud.google.com/dataplex/dp-search)\n\n \u003cbr /\u003e\n\n2. Select **Dataplex Universal Catalog** as the search mode.\n\n3. Search for the entry for which you want to view lineage information. For more\n information, see\n [Search for resources in Dataplex Universal Catalog](/dataplex/docs/search-assets).\n\n4. On the entry details page, select the **Lineage** tab.\n\n5. To view the lineage graph, click **Graph**.\n\n - Select the process or data source buttons to display the details panel.\n\n - To view upstream or downstream lineage information for a resource, click\n add **Expand**.\n\n6. To view lineage in list view, click **List**.\n\n7. To view the lineage path visualization, click **List** , and then select the\n target resource in the table of results. In the details panel, click\n **Target** , and then click **Visualize lineage**.\n\nView lineage in BigQuery\n------------------------\n\nYou can view data lineage information in the BigQuery web interface.\n\nTo view the lineage, follow these instructions:\n\n1. In the Google Cloud console, go to the **BigQuery** page.\n\n\n [Open the BigQuery page](https://console.cloud.google.com/bigquery)\n2. Open the table for which you want to see the data lineage.\n\n3. Click the **Lineage** tab.\n\n4. To view the lineage graph, click **Graph**.\n\n - Select the process or data source buttons to display the details panel.\n\n - To view upstream or downstream lineage information for a resource, click\n add **Expand**.\n\n5. To view lineage in list view, click **List**.\n\n6. To view the lineage path visualization, click **List** , and then select the\n target resource in the table of results. In the details panel, click\n **Target** , and then click **Visualize lineage**.\n\nView lineage in Vertex AI\n-------------------------\n\nSystems like Vertex AI Pipelines generate lineage data for\nVertex AI models and datasets. You can view data lineage information in\nthe Vertex AI UI web interface.\n| **Note:** To view the lineage of Vertex AI operations, such as the training, test, and evaluation data used or hyperparameters applied, see [Track the lineage of pipeline artifacts](/vertex-ai/docs/pipelines/lineage).\n\n### View lineage for a managed dataset in Vertex AI\n\nTo view the lineage for a dataset, follow these instructions:\n\n1. In the Google Cloud console, go to the **Datasets** page.\n\n\n [Open the Datasets page](https://console.cloud.google.com/vertex-ai/datasets)\n2. Click the dataset for which you want to see the data lineage.\n\n3. Click the **Lineage** tab.\n\n4. To view the lineage graph, click **Graph**.\n\n - Select the process or data source buttons to display the details panel.\n\n - To view upstream or downstream lineage information for a resource, click\n add **Expand**.\n\n5. To view lineage in list view, click **List**.\n\n6. To view the lineage path visualization, click **List** , and then select the\n target resource in the table of results. In the details panel, click\n **Target** , and then click **Visualize lineage**.\n\n| **Note:** On the lineage graph, Vertex AI processes are preceded by the . These processes include Vertex AI Pipelines components and templates, and Vertex ML Metadata artifacts, datasets, and models. If the process is cataloged in Dataplex Universal Catalog with a fully qualified domain name (FQN), you can click the entry in the lineage graph to view its details. Alternatively, to view the lineage graph details in Vertex AI, click **Open in Vertex AI** in the **Details** pane.\n\n### View lineage for a model in Vertex AI\n\nTo view the lineage for a model, follow these instructions:\n\n1. In the Google Cloud console, go to the **Model Registry** page.\n\n\n [Open the Model Registry page](https://console.cloud.google.com/vertex-ai/models)\n\n \u003cbr /\u003e\n\n2. Click the model for which you want to see the data lineage.\n\n3. Click the **Lineage** tab.\n\n4. To view the lineage graph, click **Graph**.\n\n - Select the process or data source buttons to display the details panel.\n\n - To view upstream or downstream lineage information for a resource, click\n add **Expand**.\n\n5. To view lineage in list view, click **List**.\n\n6. To view the lineage path visualization, click **List** , and then select the\n target resource in the table of results. In the details panel, click\n **Target** , and then click **Visualize lineage**.\n\n| **Note:** On the lineage graph, Vertex AI processes are preceded by the . These processes include Vertex AI Pipelines components and templates, and Vertex ML Metadata artifacts, datasets, and models. If the process is cataloged in Dataplex Universal Catalog with a fully qualified domain name (FQN), you can click the entry in the lineage graph to view its details. Alternatively, to view the lineage graph details in Vertex AI, click **Open in Vertex AI** in the **Details** pane.\n\nWhat's next\n-----------\n\n- [Track data lineage for a BigQuery table's copy and query jobs](/dataplex/docs/track-lineage-quickstart).\n\n- Learn about [Data lineage information model](/dataplex/docs/about-data-lineage#information-model)."]]
