Gerenciar seus recursos do AlloyDB usando o Dataplex Universal Catalog

Você pode pesquisar e gerenciar seus recursos do AlloyDB para PostgreSQL usando o Dataplex Universal Catalog, uma plataforma para armazenar, gerenciar e acessar seus metadados. É possível usar o Dataplex Universal Catalog para descobrir e entender os metadados do AlloyDB. Use o Dataplex Universal Catalog para ajudar com o seguinte:

  • Análise, incluindo dependências e adequação a um caso de uso
  • Gestão da mudança
  • Evolução do esquema

O Dataplex Universal Catalog recupera automaticamente os seguintes metadados do AlloyDB:

Resource type Metadados recuperados
Clusters, bancos de dados e instâncias
  • Nome
  • Local (região)
Esquema, colunas, tabelas, visualizações
  • Nome
  • Local (região)
  • Descrição
  • Esquema

Tipos de descoberta de metadados

A descoberta de metadados, no contexto do Dataplex Universal Catalog, é o processo automatizado em que o Dataplex Universal Catalog verifica fontes de dados conectadas, como o AlloyDB, para identificar recursos de dados (como tabelas, visualizações e bancos de dados) e extrair os metadados técnicos (como esquemas, descrições e locais) para o catálogo.

Esse processo é executado periodicamente para manter o catálogo sincronizado com os sistemas de origem. No AlloyDB, os metadados de cluster e instância são descobertos por padrão, enquanto os metadados de banco de dados, esquema, tabela e visualização são descobertos somente quando você ativa a integração no cluster.

O Dataplex Universal Catalog é compatível com pesquisas por palavras-chave e linguagem natural.

  • Com a pesquisa por palavra-chave, você encontra recursos usando palavras-chave, filtros e uma sintaxe definida. Por exemplo, você pode inserir system=AlloyDB AND type=Database para ver todos os bancos de dados do AlloyDB.
  • A pesquisa em linguagem natural (prévia) usa IA para entender consultas semânticas. Ele permite encontrar recursos usando linguagem cotidiana, eliminando a necessidade de sintaxes complexas. Por exemplo, você pode inserir consultas como List all AlloyDB tables related to sales.

Para mais informações, consulte Sintaxe de pesquisa do Dataplex Universal Catalog.

Exemplo: como descobrir um esquema de banco de dados do AlloyDB

Para entender o processo de descoberta de metadados, considere o exemplo de um cluster do AlloyDB chamado user-data-cluster com a integração do Dataplex Universal Catalog ativada. Na instância principal desse cluster, você tem um banco de dados chamado profiles que contém uma tabela customers (id, email, signup_date) e uma visualização active_users (id, email).

O AlloyDB é sincronizado periodicamente com o Dataplex Universal Catalog, e os seguintes recursos estão disponíveis:

  • Clusters
  • Colunas
  • Bancos de dados
  • Instâncias
  • Tabelas
  • Visualizações

Depois que a descoberta for concluída, você poderá pesquisar esses recursos (tabela customers e active_users) na página do Dataplex Universal Catalog do console Google Cloud ou usando a API, ver os esquemas e enriquecer com outros metadados operacionais ou de negócios.

Enriquecer metadados usando aspectos

Os tipos de aspecto são recursos reutilizáveis que podem ser usados como modelos para aspectos. Os tipos de aspecto ajudam a evitar a duplicação de trabalho e aspectos incompletos. É possível usar o Dataplex Universal Catalog para criar os tipos de aspecto que você precisa.

Depois de criar tipos personalizados de aspecto, é possível anexar aspectos aos seus recursos do AlloyDB. Ao anexar aspectos aos recursos do AlloyDB, você pode fazer o seguinte:

  • Adicionar metadados comerciais aos recursos
  • Pesquise recursos por metadados da empresa e outros metadados personalizados

Para saber mais sobre como criar tipos de aspecto e anexar aspectos ao AlloyDB, consulte Gerenciar aspectos e aprimorar metadados.

Fluxo de trabalho de descoberta de metadados

Por padrão, os recursos de cluster e instância são ingeridos e podem ser descobertos. Você só precisa ativar a integração do Dataplex Universal Catalog para seu cluster do AlloyDB se quiser ingerir e descobrir recursos de banco de dados, esquema, tabela e visualização.

  1. Para descobrir recursos de banco de dados, esquema, tabela e visualização do AlloyDB, ative a integração do Dataplex Universal Catalog para seu cluster do AlloyDB usando a API AlloyDB ao criar ou atualizar um cluster. Para mais informações, consulte Criar um cluster e a instância principal dele.

  2. Pesquise seus recursos do AlloyDB usando a página de pesquisa do Universal Catalog do Dataplex no console Google Cloud . Para mais informações, consulte Pesquisar recursos no Dataplex Universal Catalog.

  3. Para adicionar mais contexto aos seus recursos do AlloyDB, é possível anexar aspectos a eles. Os aspectos são entradas de metadados personalizados que ajudam na governança e na análise de dados. Por exemplo, você pode usar um aspecto para rotular uma coluna que contenha informações de identificação pessoal (PII). Para mais informações, consulte Gerenciar aspectos e enriquecer metadados.

  4. Agora você pode navegar pelos recursos do AlloyDB seguindo esta hierarquia: Cluster > Banco de dados > Esquema > Tabela ou visualização > Coluna. Isso oferece uma visão detalhada do cenário de dados. Para mais informações, consulte Pesquisar recursos no Dataplex Universal Catalog.

Antes de começar

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  5. Verify that billing is enabled for your Google Cloud project.

  6. Ativar a API Dataplex para o projeto.

    Ativar a API Dataplex

  7. Verifique as permissões.

    Você precisa de determinados papéis e permissões do Identity and Access Management (IAM) para pesquisar e anexar entradas a recursos do AlloyDB. Para mais detalhes, consulte Permissões e papéis do IAM necessários para o Dataplex Universal Catalog.

  8. Papéis necessários do IAM

    Nesta seção, descrevemos os papéis e as permissões necessários para pesquisar recursos e acessar os resultados da pesquisa.

    Papéis necessários para acessar os resultados da pesquisa

    Para pesquisar e visualizar metadados do AlloyDB no Dataplex Universal Catalog, os principais precisam ter permissões para acessar recursos do AlloyDB, incluindo a permissão dataplex.projects.search.

    Para conceder a principais (como usuários, grupos ou contas de serviço) essas permissões, atribua a eles o papel do IAM de Leitor do AlloyDB (roles/alloydb.viewer) no projeto que contém os recursos do AlloyDB.

    Operação do Dataplex Universal Catalog Recurso do AlloyDB Funções ou permissões necessárias
    Pesquisar recursos do AlloyDB Cluster alloydb.clusters.get
    Colunas alloydb.databases.get
    Instância alloydb.instances.get
    Banco de dados alloydb.databases.get
    Tabelas alloydb.databases.get
    Visualizações alloydb.databases.get

    Se você não quiser usar o papel predefinido Leitor do AlloyDB, atribua um papel personalizado que inclua as permissões alloydb.clusters.get, alloydb.instances.get e alloydb.databases.get.

    Para mais informações sobre como conceder papéis, consulte Gerenciar o acesso. Para mais informações sobre papéis do IAM do AlloyDB, consulte Papéis e permissões do IAM para o AlloyDB.

    Funções necessárias para pesquisar entradas

    Para pesquisar entradas, você precisa de pelo menos um dos seguintes papéis do IAM no projeto usado para pesquisa:

    As permissões nos resultados da pesquisa são verificadas independentemente do projeto selecionado. Para mais informações, consulte Pesquisar recursos de dados com o Dataplex Universal Catalog.

    Ativar a integração do Catálogo Universal do Dataplex no cluster do AlloyDB

    Por padrão, os recursos de cluster e instância são ingeridos e podem ser descobertos. Você só precisa ativar a integração do Dataplex Universal Catalog para seu cluster do AlloyDB se quiser ingerir e descobrir recursos de banco de dados, esquema, tabela e visualização.

    Para ingerir e tornar seus recursos de banco de dados, esquema, tabela e visualização detectáveis, crie ou atualize o cluster usando a API AlloyDB. Ao ativar essa integração, é possível sincronizar os recursos de banco de dados, esquema, tabela e visualização de metadados do plano de dados.

    Para fazer a integração com o Dataplex Universal Catalog, use a flag dataplexConfig no nível do cluster. Para conferir os dados dos clusters secundários, ative essa flag separadamente. Para ativar a exportação de metadados do AlloyDB, como bancos de dados, esquemas e tabelas, para buckets do Cloud Storage, defina enabled como true. Esses dados ficam disponíveis para uso pelo Dataplex Universal Catalog. Esse recurso só é aplicável a instâncias principais.

    Ativar a integração do Dataplex Universal Catalog ao criar um cluster

    Para criar um cluster do AlloyDB com a integração do Dataplex Universal Catalog ativada, use o método POST e o seguinte URL. Para uma lista completa de parâmetros dessa chamada, consulte Método: projects.locations.clusters.create. Para informações sobre as configurações de cluster, consulte Ver configurações de cluster e instância.

    Não inclua informações sensíveis ou de identificação pessoal no ID do cluster, porque ele é visível externamente. Não é necessário incluir o ID do projeto no nome do cluster. Isso é feito automaticamente quando necessário, por exemplo, nos arquivos de registro.

    Para enviar sua solicitação, salve o corpo da solicitação em um arquivo chamado cluster_request.json:

    {
      "databaseVersion": "DATABASE_VERSION",
      "initialUser": {
        "user": "INITIAL_USERNAME",
        "password": "INITIAL_USER_PASSWORD"
      },
      "labels": {
        "test": "alloydb-cluster-full"
      },
      "dataplexConfig" : {
        "enabled" : true
      }
    }
    

    Faça as seguintes substituições:

    • DATABASE_VERSION: string de enumeração da versão do banco de dados, por exemplo, POSTGRES_16.
    • INITIAL_USERNAME: o nome de usuário que você usa para o usuário postgres padrão.
    • INITIAL_USER_PASSWORD: a senha que você usa para o usuário padrão do postgres.

    Use o método HTTP e o URL a seguir:

    POST https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters?cluster_id=CLUSTER_ID
    

    Faça as seguintes substituições:

    • PROJECT_ID: o ID ou número do projeto do projeto Google Cloud que contém o cluster.
    • LOCATION_ID: o ID da região do cluster.
    • CLUSTER_ID: o ID do cluster que você criou. O ID do cluster precisa começar com uma letra minúscula e pode conter letras minúsculas, números e hifens.

    Para enviar a solicitação, use uma das seguintes opções:

    curl (Linux, macOS ou Cloud Shell)

    Salve o corpo da solicitação em um arquivo chamado request.json e execute o comando a seguir:

        curl -X POST \
             -H "Authorization: Bearer $(gcloud auth print-access-token)" \
             -H "Content-Type: application/json; charset=utf-8" \
             -d @request.json \
            "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters?cluster_id=CLUSTER_ID"
          

    PowerShell (Windows)

    Salve o corpo da solicitação em um arquivo chamado request.json e execute o comando a seguir:

    $cred = gcloud auth print-access-token
    $headers = @{ "Authorization" = "Bearer $cred" }
    
    Invoke-WebRequest `
        -Method POST `
        -Headers $headers `
        -ContentType: "application/json; charset=utf-8" `
        -InFile request.json `
        -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters?cluster_id=CLUSTER_ID"| Select-Object -Expand Content
    

    Você vai receber uma resposta JSON semelhante a esta:

    Resposta

    {
      "kind": "alloydb#operation",
      "targetLink": "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID",
      "status": "PENDING",
      "user": "user@example.com",
      "insertTime": "2024-09-25T22:19:33.735Z",
      "operationType": "CREATE",
      "name": "OPERATION_ID",
      "targetId": "CLUSTER_ID",
      "selfLink": "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
      "targetProject": "PROJECT_ID"
    }

    Ativar a integração do Dataplex Universal Catalog para seu cluster do AlloyDB

    Para atualizar campos específicos de um cluster atual, use o método PATCH no projects.locations.clusters resource.

    Use o método HTTP e o URL a seguir:

    PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID
    

    Faça as seguintes substituições:

    • PROJECT_ID: o ID ou número do projeto do projeto do Google Cloud que contém o cluster. Google Cloud
    • CLUSTER_ID: o nome do cluster.

    Corpo JSON da solicitação:

    {
      "dataplexConfig": {
        "enabled": true
      }
    }
    

    Para enviar a solicitação, use uma das seguintes opções:

    curl (Linux, macOS ou Cloud Shell)

    Salve o corpo da solicitação em um arquivo chamado request.json e execute o comando a seguir:

        curl -X PATCH \
             -H "Authorization: Bearer $(gcloud auth print-access-token)" \
             -H "Content-Type: application/json; charset=utf-8" \
             -d @request.json \
            "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID"
          

    PowerShell (Windows)

    Salve o corpo da solicitação em um arquivo chamado request.json e execute o comando a seguir:

    $cred = gcloud auth print-access-token
    $headers = @{ "Authorization" = "Bearer $cred" }
    
    Invoke-WebRequest `
        -Method PATCH `
        -Headers $headers `
        -ContentType: "application/json; charset=utf-8" `
        -InFile request.json `
        -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID"| Select-Object -Expand Content
    

    Você vai receber uma resposta JSON semelhante a esta:

    Resposta

    {
      "kind": "alloydb#operation",
      "targetLink": "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID",
      "status": "PENDING",
      "user": "user@example.com",
      "insertTime": "2024-09-25T22:19:33.735Z",
      "operationType": "UPDATE",
      "name": "OPERATION_ID",
      "targetId": "CLUSTER_ID",
      "selfLink": "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
      "targetProject": "PROJECT_ID"
    }

    Verificar a integração do Dataplex Universal Catalog no cluster do AlloyDB

    Para verificar se a integração do Dataplex Universal Catalog está ativada em um cluster atual, use o método GET.

    Use o método HTTP e o URL a seguir:

    GET https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID
    

    Faça as seguintes substituições:

    • PROJECT_ID: o ID ou número do projeto do projeto Google Cloud que contém o cluster.
    • CLUSTER_ID: o ID do cluster.

    Para enviar a solicitação, use uma das seguintes opções:

    curl (Linux, macOS ou Cloud Shell)

    Salve o corpo da solicitação em um arquivo chamado request.json e execute o comando a seguir:

    curl -X GET \
         -H "Authorization: Bearer $(gcloud auth print-access-token)" \
         "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID"
          

    PowerShell (Windows)

    Salve o corpo da solicitação em um arquivo chamado request.json e execute o comando a seguir:

    $cred = gcloud auth print-access-token
    $headers = @{ "Authorization" = "Bearer $cred" }
    
    Invoke-WebRequest `
        -Method GET `
        -Headers $headers `
        -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID"| Select-Object -Expand Content
    

    Você recebe uma resposta JSON para todo o proto do cluster. Procure a mensagem dataplexConfig dentro do proto:

    {
    "dataplexConfig":
      {
      "enabled": true
      }
    }

    Desativar a integração do Dataplex Universal Catalog no cluster do AlloyDB

    Use o exemplo a seguir para desativar a integração. Quando você desativa esse recurso, apenas os metadados do cluster e da instância ficam disponíveis.

    Use o método HTTP e o URL a seguir:

    PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID
    

    Faça as seguintes substituições:

    • PROJECT_ID: o ID ou número do projeto do projeto do Google Cloud que contém o cluster. Google Cloud
    • CLUSTER_ID: o ID do cluster.

    Corpo JSON da solicitação:

    {
      "dataplexConfig": {
        "enabled": false
      }
    }
    

    Para enviar a solicitação, expanda uma destas opções:

    curl (Linux, macOS ou Cloud Shell)

    Salve o corpo da solicitação em um arquivo chamado request.json e execute o comando a seguir:

    curl -X PATCH \
         -H "Authorization: Bearer $(gcloud auth print-access-token)" \
         -H "Content-Type: application/json; charset=utf-8" \
         -d @request.json \
         "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID"
          

    PowerShell (Windows)

    Salve o corpo da solicitação em um arquivo chamado request.json e execute o comando a seguir:

    $cred = gcloud auth print-access-token
    $headers = @{ "Authorization" = "Bearer $cred" }
    
    Invoke-WebRequest `
        -Method PATCH `
        -Headers $headers `
        -ContentType: "application/json; charset=utf-8" `
        -InFile request.json `
        -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID"| Select-Object -Expand Content
    

    Você vai receber uma resposta JSON semelhante a esta:

    Resposta

    {
      "kind": "alloydb#operation",
      "targetLink": "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID",
      "status": "PENDING",
      "user": "user@example.com",
      "insertTime": "2024-01-16T02:32:12.281Z",
      "operationType": "UPDATE",
      "name": "OPERATION_ID",
      "targetId": "CLUSTER_ID",
      "selfLink": "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
      "targetProject": "PROJECT_ID"
    }

    Enriquecer recursos do AlloyDB com aspectos

    Os tipos de aspecto são recursos reutilizáveis que podem ser usados como modelos. Os tipos de aspecto ajudam a evitar a duplicação de trabalho e aspectos incompletos. É possível usar o Dataplex Universal Catalog para criar os tipos de aspecto que você precisa.

    Depois de criar tipos personalizados de aspecto, é possível anexar aspectos aos seus recursos do AlloyDB. Ao anexar aspectos aos recursos do AlloyDB você pode fazer o seguinte:

    • Adicionar metadados comerciais aos recursos
    • Pesquise recursos por metadados da empresa e outros metadados personalizados

    Para saber mais sobre como criar tipos de aspecto e anexar aspectos ao AlloyDB, consulte Gerenciar aspectos e aprimorar metadados.

    Pesquisar recursos do AlloyDB

    Use a página de pesquisa do Universal Catalog do Dataplex no console Google Cloud para pesquisar recursos do AlloyDB.

    1. Acesse a página Pesquisa do Dataplex Universal Catalog.

      Acesse Pesquisar

    2. Em Escolher plataforma de pesquisa, selecione Catálogo Universal do Dataplex.

    3. No painel Filtros, clique em Sistemas e selecione AlloyDB.

    4. Opcional. Em Aliases de tipo, é possível filtrar os resultados da pesquisa para um tipo específico de recurso do AlloyDB selecionando um ou mais dos seguintes aliases de tipo:

      • Banco de dados
      • Database schema
      • Cluster
      • Instância
      • Serviço
      • Tabela
      • Ver

    É possível usar o campo de pesquisa no Dataplex Universal Catalog para realizar consultas de pesquisa por palavra-chave. Por exemplo, insira system=AlloyDB AND type=Database para ver todos os bancos de dados do AlloyDB.

    Para mais informações, consulte Sintaxe de pesquisa do Dataplex Universal Catalog.

    Para ver todos os recursos do AlloyDB, insira system=AlloyDB.

    Em seguida, insira palavras-chave específicas. Por exemplo, para ver todos os bancos de dados do AlloyDB:

    system=AlloyDB AND type=Database
    

    Para conferir todas as tabelas do AlloyDB, insira a seguinte consulta:

    system=AlloyDB AND type=Table
    

    Também é possível usar parênteses e os operadores lógicos AND e OR para expressões complexas. Para saber mais sobre as expressões que você pode usar no campo de pesquisa, consulte Sintaxe de pesquisa para o Dataplex Universal Catalog.

    É possível inserir diretamente consultas de pesquisa para recursos específicos do AlloyDB no campo de pesquisa. O formato da string de consulta é o seguinte:

    type="projects/dataplex-types/locations/global/entryTypes/QUERY_STRING"

    Substitua:

    • QUERY_STRING: use a lista a seguir para identificar uma string de consulta com base no tipo de recurso do AlloyDB que você quer consultar:

      • alloydb-database
      • alloydb-cluster
      • alloydb-instance
      • alloydb-table
      • alloydb-schema
      • alloydb-view

    Um exemplo de consulta pode ser semelhante ao seguinte:

    type="projects/1234567890/locations/global/entryTypes/alloydb-cluster"
    

    Pesquisar por tipo de aspecto

    O Dataplex Universal Catalog inclui alguns tipos de aspectos integrados que você pode usar para realizar pesquisas.

    Para pesquisar por tipo de aspecto, siga estas etapas:

    1. No painel Aspectos, clique no menu Adicionar mais tipos de aspecto.
    2. Opcional. Selecione Acesso ao AlloyDB para filtrar os resultados por dialeto do AlloyDB.
    3. Selecione um ou mais dos seguintes tipos de aspecto para limitar os resultados da pesquisa a esse tipo.
      • Banco de dados do AlloyDB
      • Cluster do AlloyDB
      • Instância do AlloyDB
      • Visualização do AlloyDB
      • Esquema do AlloyDB
      • Tabela do AlloyDB
    4. Clique em OK.
    5. Na tabela de resultados, clique no nome do recurso para visualizar os metadados dele.
    6. Opcional: aprimore ou visualize seus recursos. Você pode fazer o seguinte:
      • Para adicionar uma descrição em rich text do recurso, em Visão geral, clique em Adicionar .
      • Para anexar um aspecto ao recurso, em Aspectos, clique em Adicionar .
      • Para conferir os bancos de dados de membros de uma instância, clique na guia Lista de entradas e depois em Mostrar todas as entradas filhas na pesquisa. Se a guia Lista de entradas não aparecer, isso significa que o cluster não tem bancos de dados.
      • Em Detalhes da entrada, confira todos os detalhes do recurso. Clique no nome da entrada para detalhar até entradas adicionais.

    Pesquisa com linguagem natural no AlloyDB

    A pesquisa em linguagem natural (prévia) usa IA para entender consultas semânticas. Ele permite encontrar recursos usando linguagem cotidiana, eliminando a necessidade de sintaxe complexa. Por exemplo, você pode inserir consultas como List all AlloyDB tables related to sales.

    Para mais informações, consulte Sintaxe de pesquisa do Dataplex Universal Catalog.

    Pesquisa de sintaxe no AlloyDB

    Com a pesquisa por palavra-chave, você encontra recursos usando palavras-chave, filtros e uma sintaxe definida. Por exemplo, você pode inserir system=AlloyDB AND type=Database para ver todos os bancos de dados do AlloyDB.

    Para mais informações, consulte Sintaxe de pesquisa do Dataplex Universal Catalog.

    Exemplo de fluxo de trabalho: detalhamento do cluster para as colunas

    Para detalhar do cluster até as colunas, siga estas etapas:

    1. Acesse a página Pesquisa do Dataplex Universal Catalog.

      Acesse Pesquisar

    2. Na opção Escolher plataforma de pesquisa, selecione Dataplex Universal Catalog.

    3. No painel Filtros, selecione Sistemas e, em seguida, AlloyDB. Se preferir, digite system=AlloyDB no campo de pesquisa.

    4. Selecione um nome de cluster.

    5. Na página Detalhes do AlloyDB, clique na guia Lista de entradas e depois em Mostrar todas as entradas filhas na pesquisa. O Dataplex Universal Catalog mostra os bancos de dados no cluster.

    6. Na página Detalhes do banco de dados do AlloyDB, clique na guia Lista de entradas e depois em Exibir entradas filhas na pesquisa. O Dataplex Universal Catalog mostra as tabelas no cluster.

    7. Selecione um nome de tabela e, na página Detalhes da tabela do AlloyDB, clique em Esquema para ver as colunas da tabela.

    8. Opcional: para adicionar um tipo de aspecto a uma coluna, clique no botão Adicionar aspecto.

    Preços

    Não há custos para armazenar metadados técnicos do AlloyDB no Dataplex Universal Catalog. Os preços padrão do Dataplex Universal Catalog se aplicam a chamadas de API e ao aprimoramento de outros metadados comerciais. Para mais informações, consulte a Página de preços do Dataplex Universal Catalog.

    Uso de recursos

    O Dataplex Universal Catalog extrai dados dos seus clusters periodicamente. O processo de extração exige uma certa quantidade de uso da CPU. Clusters com tipos de máquina menores, por exemplo, máquinas que compartilham esquemas maiores (10.000 ou mais tabelas), podem usar uma pequena quantidade da CPU durante o processo de extração.

    Limitações

    • É permitido no máximo um milhão de tabelas por banco de dados.
    • Pode levar até 48 horas para que as atualizações do banco de dados sejam refletidas no Dataplex Universal Catalog.
    • O processo de extração normalmente leva alguns minutos, mas o tempo até a conclusão depende do tamanho da CPU e da contagem de tabelas.
    • Quando uma instância não existe ou não está em execução, pode levar sete dias para que os metadados sejam excluídos.

    A seguir