Solicitar mudanças de metadados com fluxos de trabalho de governança

Neste documento, descrevemos como propor mudanças em um único recurso para categorias e termos do glossário empresarial, bem como entradas do Knowledge Catalog (antigo Dataplex Universal Catalog), usando fluxos de trabalho de governança.

Antes de começar

Para usar fluxos de trabalho de governança para mudanças de metadados, verifique se você ativou as APIs necessárias e se tem os papéis e as permissões necessários do Identity and Access Management (IAM).

Ative a API Dataplex, se ainda não tiver feito isso.

Funções necessárias para ativar APIs

Para ativar APIs, você precisa da permissão serviceusage.services.enable. Se você criou o projeto, provavelmente já tem essa permissão pelo papel de proprietário (roles/owner). Caso contrário, é possível conseguir essa permissão pelo papel de administrador do Service Usage (roles/serviceusage.serviceUsageAdmin). Saiba como conceder papéis.

Ativar a API

Funções exigidas

Para receber as permissões necessárias para solicitar mudanças de metadados, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto, glossário ou grupo de entradas:

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

Para mais informações sobre papéis e permissões, consulte Papéis do IAM do Knowledge Catalog.

Solicitar mudanças em uma categoria de glossário

Se você não tiver acesso de gravação direta para criar, atualizar ou excluir uma categoria de glossário, solicite essa alteração usando fluxos de trabalho de governança. Depois que uma solicitação de mudança de metadados é enviada, os solicitantes, aprovadores e administradores de fluxo de trabalho podem monitorar e gerenciar a solicitação durante todo o ciclo de vida.

Criar uma categoria

Console

Siga estas etapas para solicitar uma categoria:

  1. No console Google Cloud , acesse a página Glossários do Knowledge Catalog.

    Acessar Glossários

  2. Selecione o glossário em que você quer criar uma categoria e clique em Criar categoria.

  3. Insira um Nome de exibição para a categoria.

  4. Opcional: na seção Rótulos, adicione rótulos para o glossário.

  5. Opcional: na seção Justificativa, informe ao aprovador o motivo da mudança.

  6. Na seção Configurações avançadas, é possível editar o ID da categoria se você quiser mudar o ID gerado automaticamente.

  7. Clique em Enviar para revisão.

O sistema registra uma nova solicitação de mudança e notifica o aprovador. É possível acompanhar o progresso da solicitação na página Fluxos de trabalho de governança, na guia Minhas solicitações.

REST

Para solicitar a criação de uma categoria, use o método glossaries.requestGlossaryChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "createCategoryRequest": {
      "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
      "categoryId": "sample-category-id",
      "category": {
        "displayName": "Sample category name",
        "description": "Sample category description",
        "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID"
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

Substitua:

  • PROJECT_ID: o ID do seu projeto do Google Cloud .
  • LOCATION: a região em que o glossário está, como us-central1.
  • GLOSSARY_ID: o ID do glossário pai.
  • JUSTIFICATION: uma explicação de por que você está propondo a mudança.

O serviço retorna uma resposta que contém o nome do recurso da solicitação de alteração. O sistema registra uma nova solicitação de mudança e notifica o aprovador.

Atualizar uma categoria

Console

Siga estas etapas para sugerir mudanças em uma categoria:

  1. No console Google Cloud , acesse a página Glossários do Knowledge Catalog.

    Acessar Glossários

  2. Selecione o glossário que inclui a categoria que você quer atualizar.

  3. Clique no nome da categoria para abrir o painel Detalhes da categoria.

  4. Para adicionar ou atualizar os detalhes da categoria, clique em Adicionar ou Editar ao lado da seção que você quer atualizar.

  5. Clique em Enviar para revisão. Alguns itens podem exigir uma justificativa adicional para a mudança. Forneça a justificativa e clique em Prosseguir para enviar as mudanças.

O sistema registra uma nova solicitação de mudança e notifica o aprovador. É possível acompanhar o progresso da solicitação na página Fluxos de trabalho de governança, na guia Minhas solicitações.

REST

Para solicitar uma atualização do nome de exibição e da descrição de uma categoria, use o método glossaries.requestGlossaryChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "updateCategoryRequest": {
      "category": {
        "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID/categories/CATEGORY_ID",
        "displayName": "Sample new name",
        "description": "Sample new description"
      },
      "updateMask": {
        "paths": [
          "display_name",
          "description"
        ]
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

Substitua:

  • PROJECT_ID: o ID do seu projeto do Google Cloud .
  • LOCATION: a região em que o glossário está, como us-central1.
  • GLOSSARY_ID: o ID do glossário pai.
  • CATEGORY_ID: o ID da categoria de destino que você quer atualizar.
  • JUSTIFICATION: uma explicação de por que você está propondo a mudança.

O serviço retorna uma resposta que contém o nome do recurso da solicitação de alteração. O sistema registra uma nova solicitação de mudança e notifica o aprovador.

Excluir uma categoria

Console

Siga estas etapas para solicitar a exclusão de uma categoria:

  1. No console Google Cloud , acesse a página Glossários do Knowledge Catalog.

    Acessar Glossários

  2. Abra o glossário e clique na categoria que você quer excluir.

  3. No painel Detalhes da categoria, selecione Excluir no menu.

  4. Opcional: na seção Justificativa, informe ao aprovador o motivo da mudança.

  5. Clique em Enviar para revisão.

O sistema registra uma nova solicitação de mudança e notifica o aprovador. É possível acompanhar o progresso da solicitação na página Fluxos de trabalho de governança, na guia Minhas solicitações.

REST

Para solicitar a exclusão de uma categoria, use o método glossaries.requestGlossaryChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "deleteCategoryRequest": {
      "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID/categories/CATEGORY_ID"
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

Substitua:

  • PROJECT_ID: o ID do seu projeto do Google Cloud .
  • LOCATION: a região em que o glossário está, como us-central1.
  • GLOSSARY_ID: o ID do glossário pai.
  • CATEGORY_ID: o ID da categoria de destino que você quer excluir.
  • JUSTIFICATION: uma explicação de por que você está propondo a mudança.

O serviço retorna uma resposta que contém o nome do recurso da solicitação de alteração. O sistema registra uma nova solicitação de mudança e notifica o aprovador.

Solicitar mudanças em um termo do glossário

Se você não tiver acesso de gravação direta para criar, atualizar ou excluir um termo do glossário, solicite essa alteração usando fluxos de trabalho de governança.

Criar um termo de glossário

Console

Siga estas etapas para solicitar a criação de um termo do glossário:

  1. No console Google Cloud , acesse a página Glossários do Knowledge Catalog.

    Acessar Glossários

  2. Selecione o glossário ou a categoria em que você quer criar um termo para abrir o painel de detalhes.

    • Se você criar um termo na página de detalhes do glossário, selecione Criar termo no menu.
    • Se você criar um termo na página de detalhes da categoria, selecione Adicionar termo no menu.

  3. Insira um Nome de exibição para a categoria.

  4. Opcional: na seção Rótulos, adicione rótulos ao termo.

  5. Opcional: na seção Justificativa, informe ao aprovador o motivo da mudança.

  6. Na seção Configurações avançadas, é possível editar o ID do termo se você quiser mudar o ID gerado automaticamente.

  7. Clique em Enviar para revisão.

O sistema registra uma nova solicitação de mudança e notifica o aprovador. É possível acompanhar o progresso da solicitação na página Fluxos de trabalho de governança, na guia Minhas solicitações.

REST

Para solicitar a criação de um termo de glossário, use o método glossaries.requestGlossaryChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "createTermRequest": {
      "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
      "termId": "sample-term-id",
      "term": {
        "displayName": "Sample term name",
        "description": "Sample term description",
        "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID"
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

Substitua:

  • PROJECT_ID: o ID do seu projeto do Google Cloud .
  • LOCATION: a região em que o glossário está, como us-central1.
  • GLOSSARY_ID: o ID do glossário pai.
  • JUSTIFICATION: uma explicação de por que você está propondo a mudança.

O serviço retorna uma resposta que contém o nome do recurso da solicitação de alteração. O sistema registra uma nova solicitação de mudança e notifica o aprovador.

Atualizar um termo do glossário

Console

Siga estas etapas para solicitar mudanças em um termo do glossário:

  1. No console Google Cloud , acesse a página Glossários do Knowledge Catalog.

    Acessar Glossários

  2. Selecione o glossário que inclui o termo que você quer atualizar.

  3. Clique no nome do termo para abrir o painel Detalhes do termo.

  4. Adicione ou atualize os detalhes do termo clicando em Adicionar ou Editar ao lado da seção que você quer atualizar.

  5. Clique em Enviar para revisão. Algumas seções podem exigir que você forneça uma justificativa adicional antes de enviar a solicitação. Forneça a justificativa e clique em Prosseguir para enviar as mudanças.

O sistema registra uma nova solicitação de mudança e notifica o aprovador. É possível acompanhar o progresso da solicitação na página Fluxos de trabalho de governança, na guia Minhas solicitações.

REST

Para solicitar uma atualização do nome de exibição e da descrição de um termo do glossário, use o método glossaries.requestGlossaryChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "updateTermRequest": {
      "term": {
        "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID/terms/TERM_ID",
        "displayName": "Sample new name",
        "description": "Sample new description"
      },
      "updateMask": {
        "paths": [
          "display_name",
          "description"
        ]
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

Substitua:

  • PROJECT_ID: o ID do seu projeto do Google Cloud .
  • LOCATION: a região em que o glossário está, como us-central1.
  • GLOSSARY_ID: o ID do glossário pai.
  • TERM_ID: o ID do termo de destino que você quer atualizar.
  • JUSTIFICATION: uma explicação de por que você está propondo a mudança.

O serviço retorna uma resposta que contém o nome do recurso da solicitação de alteração. O sistema registra uma nova solicitação de mudança e notifica o aprovador.

Excluir um termo do glossário

Console

Siga estas etapas para solicitar a exclusão de um termo:

  1. No console Google Cloud , acesse a página Glossários do Knowledge Catalog.

    Acessar Glossários

  2. Selecione o glossário que inclui o termo que você quer excluir.

  3. Clique no nome do termo para abrir o painel Detalhes do termo.

  4. Clique em Excluir.

  5. Clique em Enviar para revisão. Algumas seções podem exigir que você forneça uma justificativa adicional antes de enviar a solicitação. Forneça a justificativa e clique em Prosseguir para enviar as mudanças.

O sistema registra uma nova solicitação de mudança e notifica o aprovador. É possível acompanhar o progresso da solicitação na página Fluxos de trabalho de governança, na guia Minhas solicitações.

REST

Para solicitar a exclusão de um termo do glossário, use o método glossaries.requestGlossaryChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "deleteTermRequest": {
      "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID/terms/TERM_ID"
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

Substitua:

  • PROJECT_ID: o ID do seu projeto do Google Cloud .
  • LOCATION: a região em que o glossário está, como us-central1.
  • GLOSSARY_ID: o ID do glossário pai.
  • TERM_ID: o ID do termo de destino que você quer excluir.
  • JUSTIFICATION: uma explicação de por que você está propondo a mudança.

O serviço retorna um RequestGlossaryChangeResponse que contém o nome do recurso do ChangeRequest.O sistema registra uma nova solicitação de alteração e notifica o aprovador.

Solicitar mudanças em uma entrada

Se você não tiver acesso de gravação direta para criar, modificar ou excluir uma entrada do Knowledge Catalog, solicite essa alteração usando fluxos de trabalho de governança.

Criar uma entrada

Console

Siga estas etapas para solicitar a criação de uma entrada:

  1. No console do Google Cloud , acesse a página Tipos de metadados do Knowledge Catalog.

    Acessar Tipos de metadados

  2. Clique na guia Grupos de entradas.

  3. Selecione o grupo de entrada em que você quer criar uma entrada e clique em Criar entrada.

  4. Insira um ID e um nome de exibição para a entrada.

  5. Selecione um tipo de entrada.

  6. Opcional: forneça detalhes do aspecto ou adicione uma descrição.

  7. Clique em Enviar para revisão. Algumas seções podem exigir que você forneça uma justificativa adicional antes de enviar a solicitação. Forneça a justificativa e clique em Prosseguir para enviar as mudanças.

O sistema registra uma nova solicitação de mudança e notifica o aprovador. É possível acompanhar o progresso da solicitação na página Fluxos de trabalho de governança, na guia Minhas solicitações.

REST

Para solicitar a criação de uma entrada, use o método entryGroups.requestCatalogChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "createEntryRequest": {
      "parent": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
      "entryId": "sample-entry-id",
      "entry": {
        "entryType": "projects/PROJECT_ID/locations/LOCATION/entryTypes/ENTRY_TYPE_ID",
        "entrySource": {
          "displayName": "Sample entry name",
          "description": "Sample entry description"
        }
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

Substitua:

  • PROJECT_ID: o ID do seu projeto do Google Cloud .
  • LOCATION: a região em que o grupo de entrada existe, como us-central1.
  • ENTRY_GROUP_ID: o ID do grupo de entrada pai.
  • ENTRY_TYPE_ID: o ID do tipo de entrada.
  • JUSTIFICATION: uma explicação de por que você está propondo a mudança.

O serviço retorna uma resposta que contém o nome do recurso da solicitação de alteração. O sistema registra uma nova solicitação de mudança e notifica o aprovador.

Atualizar uma entrada

Console

Siga estas etapas para solicitar atualizações de uma entrada:

  1. No console Google Cloud , acesse a página Pesquisa ou Catálogo do Knowledge Catalog.

Acesse Pesquisar

  1. Pesquise e selecione a entrada que você quer atualizar.
  2. Clique na entrada para abrir a página Detalhes da entrada.
  3. Clique em Adicionar ao lado da seção que você quer atualizar.
  4. Atualize a seção.
  5. Clique em Enviar para revisão. Algumas seções podem exigir que você forneça uma justificativa adicional antes de enviar a solicitação. Forneça a justificativa e clique em Prosseguir para enviar as mudanças.

O sistema registra uma nova solicitação de mudança e notifica o aprovador. É possível acompanhar o progresso da solicitação na página Fluxos de trabalho de governança, na guia Minhas solicitações.

REST

Para solicitar uma atualização do nome de exibição e da descrição de uma origem de entrada, use o método entryGroups.requestCatalogChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "updateEntryRequest": {
      "entry": {
        "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID",
        "entrySource": {
          "displayName": "Sample new name",
          "description": "Sample new description"
        }
      },
      "updateMask": {
        "paths": [
          "entry_source.display_name",
          "entry_source.description"
        ]
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

Substitua:

  • PROJECT_ID: o ID do seu projeto do Google Cloud .
  • LOCATION: a região em que o grupo de entrada existe, como us-central1.
  • ENTRY_GROUP_ID: o ID do grupo de entrada pai.
  • ENTRY_ID: o ID da entrada de destino.
  • JUSTIFICATION: uma explicação de por que você está propondo a mudança.

O serviço retorna uma resposta que contém o nome do recurso da solicitação de alteração. O sistema registra uma nova solicitação de mudança e notifica o aprovador.

Excluir uma entrada

Console

Siga estas etapas para solicitar a exclusão de uma entrada:

  1. No console Google Cloud , acesse a página Pesquisa ou Catálogo do Knowledge Catalog.

Acesse Pesquisar

  1. Pesquise e selecione a entrada que você quer excluir.
  2. Clique na entrada para abrir a página Detalhes da entrada.
  3. Clique em Excluir.
  4. Clique em Enviar para revisão. Algumas seções podem exigir que você forneça uma justificativa adicional antes de enviar a solicitação. Forneça a justificativa e clique em Prosseguir para enviar as mudanças.

O sistema registra uma nova solicitação de mudança e notifica o aprovador. É possível acompanhar o progresso da solicitação na página Fluxos de trabalho de governança, na guia Minhas solicitações.

REST

Para solicitar a exclusão de uma entrada, use o método entryGroups.requestCatalogChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "deleteEntryRequest": {
      "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID"
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

Substitua:

  • PROJECT_ID: o ID do seu projeto do Google Cloud .
  • LOCATION: a região em que o grupo de entrada existe, como us-central1.
  • ENTRY_GROUP_ID: o ID do grupo de entrada pai.
  • ENTRY_ID: o ID da entrada de destino que você quer excluir.
  • JUSTIFICATION: uma explicação de por que você está propondo a mudança.

O serviço retorna uma resposta que contém o nome do recurso da solicitação de alteração. O sistema registra uma nova solicitação de mudança e notifica o aprovador.

Atualizar um aspecto

Console

Siga estas etapas para solicitar atualizações de um aspecto:

  1. No console Google Cloud , acesse a página Pesquisa do Knowledge Catalog.

Acesse Pesquisar

  1. Pesquise e selecione a entrada que você quer mudar.
  2. Clique na entrada para abrir a página Detalhes da entrada.
  3. Acesse a seção Aspectos e clique em Adicionar.
  4. Forneça detalhes do aspecto.
  5. Opcional: justifique a mudança.
  6. Clique em Enviar para revisão.

O sistema registra uma nova solicitação de mudança e notifica o aprovador. É possível acompanhar o progresso da solicitação na página Fluxos de trabalho de governança, na guia Minhas solicitações.

REST

Para solicitar a anexação ou atualização de um aspecto de Contatos em uma entrada, use o método entryGroups.requestCatalogChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "updateEntryRequest": {
      "entry": {
        "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID",
        "aspects": {
          "dataplex-types.global.contacts": {
            "data": {
              "identities": [
                {
                  "role": "Data Steward",
                  "name": "Dana",
                  "id": "dana@example.com"
                }
              ]
            }
          }
        }
      },
      "updateMask": {
        "paths": [
          "aspects"
        ]
      },
      "aspectKeys": [
        "dataplex-types.global.contacts"
      ]
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

Substitua:

  • PROJECT_ID: o ID do seu projeto do Google Cloud .
  • LOCATION: a região em que o grupo de entrada existe, como us-central1.
  • ENTRY_GROUP_ID: o ID do grupo de entrada pai.
  • ENTRY_ID: o ID da entrada de destino.
  • JUSTIFICATION: uma explicação de por que você está propondo a mudança.

O serviço retorna uma resposta que contém o nome do recurso da solicitação de alteração. O sistema registra uma nova solicitação de mudança e notifica o aprovador.

Criar um link de entrada

Console

Siga estas etapas para solicitar a criação de um link de entrada, por exemplo, para anexar um termo do glossário:

  1. No console Google Cloud , acesse a página Pesquisa do Knowledge Catalog.

    Acesse Pesquisar

  2. Pesquise e selecione a entrada do recurso de dados à qual você quer vincular um termo.

  3. Na página de detalhes da entrada, siga um destes procedimentos:

    • Para vincular um termo à entrada, na guia Detalhes, na seção Termos do glossário, clique em Adicionar.
    • Para vincular um termo a uma coluna, na guia Esquema, selecione a coluna e clique em Adicionar termo comercial.

  4. Pesquise e selecione o termo que você quer vincular.

  5. Opcional: justifique a mudança.

  6. Clique em Enviar para revisão.

O sistema registra uma nova solicitação de mudança e notifica o aprovador. É possível acompanhar o progresso da solicitação na página Fluxos de trabalho de governança, na guia Minhas solicitações.

REST

Para solicitar a criação de um link de definição entre um termo do glossário e uma entrada de recurso de dados, use o método entryGroups.requestCatalogChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "createEntryLinkRequest": {
      "parent": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
      "entryLinkId": "sample-definition-link",
      "entryLink": {
        "entryLinkType": "projects/dataplex-types/locations/global/entryLinkTypes/definition",
        "entryReferences": [
          {
            "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID",
            "type": "SOURCE"
          },
          {
            "name": "projects/PROJECT_ID/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_ID/locations/global/glossaries/GLOSSARY_ID/terms/TERM_ID",
            "type": "TARGET"
          }
        ]
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

Substitua:

  • PROJECT_ID: o ID do seu projeto do Google Cloud .
  • LOCATION: a região em que o grupo de entrada existe, como us-central1.
  • ENTRY_GROUP_ID: o ID do grupo de entrada pai.
  • ENTRY_ID: o ID da entrada de destino.
  • GLOSSARY_ID: o ID do glossário que contém o termo.
  • TERM_ID: o ID do termo do glossário.
  • JUSTIFICATION: uma explicação de por que você está propondo a mudança.

O serviço retorna uma resposta que contém o nome do recurso da solicitação de alteração. O sistema registra uma nova solicitação de mudança e notifica o aprovador.

Excluir um link de entrada

Console

Siga estas etapas para solicitar a exclusão de um link de entrada, por exemplo, para remover um termo de glossário anexado:

  1. No console Google Cloud , acesse a página Pesquisa do Knowledge Catalog.

    Acesse Pesquisar

  2. Pesquise e selecione a entrada do recurso de dados de que você quer remover um termo vinculado.

  3. Na página de detalhes da entrada, siga um destes procedimentos:

    • Para remover um termo da entrada, na guia Detalhes, na seção Termos do glossário, clique no termo e em Remover.
    • Para remover um termo de uma coluna, na guia Esquema, clique em Remover ao lado do termo.

  4. Opcional: justifique a mudança.

  5. Clique em Enviar para revisão.

O sistema registra uma nova solicitação de mudança e notifica o aprovador. É possível acompanhar o progresso da solicitação na página Fluxos de trabalho de governança, na guia Minhas solicitações.

REST

Para solicitar a exclusão de um link de entrada entre um termo de glossário e uma entrada de recurso de dados, use o método entryGroups.requestCatalogChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "deleteEntryLinkRequest": {
      "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entryLinks/ENTRY_LINK_ID"
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

Substitua:

  • PROJECT_ID: o ID do seu projeto do Google Cloud .
  • LOCATION: a região em que o grupo de entrada existe, como us-central1.
  • ENTRY_GROUP_ID: o ID do grupo de entrada pai.
  • ENTRY_LINK_ID: o ID do link de entrada de destino que você quer excluir.
  • JUSTIFICATION: uma explicação de por que você está propondo a mudança.

O serviço retorna uma resposta que contém o nome do recurso da solicitação de alteração. O sistema registra uma nova solicitação de mudança e notifica o aprovador.

A seguir