Gestisci le risorse AlloyDB utilizzando Knowledge Catalog

L'integrazione di Knowledge Catalog è abilitata per impostazione predefinita per tutti i nuovi cluster AlloyDB, consentendoti di cercare e gestire le tue risorse AlloyDB per PostgreSQL utilizzando Knowledge Catalog, una piattaforma che ti consente di archiviare, gestire e accedere ai metadati. Questa integrazione ti aiuta a scoprire e comprendere i metadati di AlloyDB, supportando i seguenti casi d'uso:

  • Analisi: comprendere le dipendenze e valutare l'idoneità per vari casi d'uso.
  • Gestione delle modifiche: monitora e gestisci le modifiche ai metadati in modo efficace.
  • Evoluzione dello schema: monitora e pianifica le modifiche allo schema.

Knowledge Catalog recupera automaticamente i seguenti metadati da cluster, istanze, database, tabelle, colonne e viste AlloyDB:

  • Nome
  • Località (regione)
  • Etichette (per cluster e istanze)
  • Integrazione Dataplex abilitata (per i cluster)
  • Versione database
  • Conteggio CPU della macchina (per le istanze)
  • Tipo di disponibilità (per le istanze)
  • Set di caratteri (per i database)
  • Regole di confronto (per i database)
  • Proprietario
  • Descrizione (per tabelle, viste, colonne e chiavi esterne)
  • Tipo (per cluster, istanze e macchine)
  • Colonne
    • Tipo di dati
    • Modalità
  • Chiave primaria
  • Chiavi esterne
    • Tabella di riferimento
    • Mappature delle colonne
  • Ora creazione
  • Data/ora ultima modifica

Per saperne di più, consulta Informazioni sulla gestione dei metadati in Knowledge Catalog.

Tipi di rilevamento dei metadati

Il rilevamento dei metadati di Knowledge Catalog è un processo automatizzato che analizza le origini dati connesse, come AlloyDB, per identificare gli asset di dati come tabelle, viste e database. Poi, Knowledge Catalog estrae i metadati tecnici dagli asset, come schemi, descrizioni e posizioni, in Knowledge Catalog.

Questo processo sincronizza i metadati quasi in tempo reale, mantenendo il catalogo sincronizzato con i sistemi di origine. Per AlloyDB, i metadati del cluster e dell'istanza vengono rilevati per impostazione predefinita. Il rilevamento dei metadati di database, schemi, tabelle e viste è abilitato per impostazione predefinita sui nuovi cluster. Per i cluster creati prima dell'implementazione di questa impostazione predefinita (26 febbraio 2026), attiva l'integrazione manualmente.

Knowledge Catalog supporta le ricerche per parole chiave e in linguaggio naturale.

  • La ricerca per parole chiave ti aiuta a trovare le risorse utilizzando parole chiave specifiche, filtri e una sintassi definita. Ad esempio, per visualizzare tutti i database AlloyDB, inserisci system=AlloyDB AND type=Database.
  • La ricerca in linguaggio naturale utilizza l'AI per comprendere le query semantiche. Ti aiuta a trovare le risorse utilizzando un linguaggio naturale, eliminando la necessità di una sintassi complessa. Ad esempio, inserisci una query come List all AlloyDB tables related to sales.

Per saperne di più, consulta Sintassi di ricerca per Knowledge Catalog.

Esempio: rilevamento di uno schema di database AlloyDB

Per comprendere il processo di rilevamento dei metadati, considera l'esempio di un cluster AlloyDB denominato user-data-cluster con l'integrazione di Knowledge Catalog abilitata. All'interno dell'istanza principale di questo cluster esiste un database denominato profiles, che contiene una tabella customers (id, email, signup_date) e una vista active_users (id, email).

Poiché AlloyDB si sincronizza quasi in tempo reale con Knowledge Catalog, sono disponibili le seguenti risorse:

  • Cluster
  • Colonne
  • Database
  • Istanze
  • Tabelle
  • Visualizzazioni

Al termine del rilevamento, cerca questi asset, la tabella customers e active_users, nella pagina Knowledge Catalog della console Google Cloud o utilizzando l'API. Poi, visualizza i loro schemi e arricchiscili con metadati aziendali o operativi aggiuntivi.

Arricchisci i metadati utilizzando gli aspetti

I tipi di aspetto sono risorse riutilizzabili che fungono da modelli per gli aspetti. I tipi di aspetto aiutano a evitare di duplicare il lavoro e di creare aspetti incompleti. Crea i tipi di aspetto necessari utilizzando Knowledge Catalog.

Dopo aver creato tipi di aspetto personalizzati, collega gli aspetti agli asset AlloyDB. Il collegamento di aspetti agli asset AlloyDB consente di:

  • Aggiungi metadati aziendali agli asset.
  • Cerca gli asset in base ai metadati aziendali e ad altri metadati personalizzati.

Per scoprire di più sulla creazione di tipi di aspetti e sul collegamento di aspetti ad AlloyDB, consulta Gestisci gli aspetti e arricchisci i metadati.

Flusso di lavoro di rilevamento dei metadati

Per impostazione predefinita, le risorse di cluster e istanze vengono importate e sono rilevabili. Per importare e rilevare risorse di database, schema, tabella e visualizzazione, segui questi passaggi:

  1. Abilita l'integrazione di Knowledge Catalog per il tuo cluster AlloyDB utilizzando l'API AlloyDB, se non è già abilitata. Questo è obbligatorio per i cluster creati prima del 26 febbraio 2026.

  2. Cerca gli asset AlloyDB utilizzando la pagina di ricerca di Knowledge Catalog nella console Google Cloud . Per saperne di più, consulta Cerca risorse in Knowledge Catalog.

  3. Per aggiungere più contesto ai tuoi asset AlloyDB, collega gli aspetti agli asset. Gli aspetti sono voci di metadati personalizzate che aiutano nella governance dei dati e nell'analisi. Ad esempio, utilizza un aspetto per etichettare una colonna che contiene informazioni che consentono l'identificazione personale (PII). Per saperne di più, consulta Gestisci gli aspetti e arricchisci i metadati.

  4. Naviga tra le risorse AlloyDB seguendo questa gerarchia: Cluster > Database > Schema > Tabella o Vista > Colonna. Questa gerarchia fornisce una visualizzazione dettagliata del panorama dei dati. Per saperne di più, consulta Cerca risorse in Knowledge Catalog.

Prima di iniziare

  1. 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

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

  3. Abilita l'API Dataplex per il progetto.

    Abilita l'API Dataplex

  4. Controlla le autorizzazioni.

    Devi disporre di ruoli e autorizzazioni Identity and Access Management (IAM) specifici per cercare e collegare voci agli asset AlloyDB. Per saperne di più, consulta Ruoli e autorizzazioni IAM richiesti per Knowledge Catalog.

Ruoli IAM richiesti

Questa sezione descrive i ruoli e le autorizzazioni necessari per cercare risorse e accedere ai risultati di ricerca.

Ruoli richiesti per accedere ai risultati di ricerca

Per cercare e visualizzare i metadati di AlloyDB in Knowledge Catalog, le entità devono disporre delle autorizzazioni per visualizzare le risorse AlloyDB, inclusa l'autorizzazione dataplex.projects.search.

Per concedere queste autorizzazioni alle entità, ad esempio utenti, gruppi o service account, assegna loro il ruolo IAM Visualizzatore AlloyDB (roles/alloydb.viewer) nel progetto che contiene le risorse AlloyDB.

Operazione di Knowledge Catalog Risorsa AlloyDB Ruoli o autorizzazioni richiesti
Cerca risorse AlloyDB Cluster alloydb.clusters.get
Colonne alloydb.databases.get
Istanza alloydb.instances.get
Database alloydb.databases.get
Tabelle alloydb.databases.get
Visualizzazioni alloydb.databases.get

Se non vuoi utilizzare il ruolo AlloyDB Viewer predefinito, assegna un ruolo personalizzato che includa le autorizzazioni alloydb.clusters.get, alloydb.instances.get e alloydb.databases.get.

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso. Per saperne di più sui ruoli IAM di AlloyDB, consulta Ruoli e autorizzazioni IAM per AlloyDB.

Ruoli obbligatori per la ricerca di voci

Devi disporre di almeno uno dei seguenti ruoli IAM nel progetto utilizzato per la ricerca:

Le autorizzazioni sui risultati di ricerca vengono controllate indipendentemente dal progetto selezionato. Per saperne di più, consulta Cerca asset di dati con Knowledge Catalog.

Aggiornamento dei dati di integrazione di Knowledge Catalog

Per impostazione predefinita, Knowledge Catalog importa e rileva le risorse di cluster e istanze e l'aggiornamento dei relativi metadati è quasi in tempo reale.

L'integrazione di Knowledge Catalog per le risorse di database, schema, tabella e visualizzazione è abilitata per impostazione predefinita quando crei un nuovo cluster AlloyDB. Per impedire la sincronizzazione di questi metadati, disattiva l'integrazione.

L'abilitazione dell'integrazione attiva l'esportazione dei metadati di AlloyDB, come database, schemi e tabelle, nei bucket Cloud Storage per la sincronizzazione periodica o negli argomenti Pub/Sub per la sincronizzazione quasi in tempo reale, rendendoli disponibili per Knowledge Catalog. Questa funzionalità è applicabile solo ai cluster principali. I cluster secondari utilizzati per la replica tra regioni non supportano l'integrazione di Knowledge Catalog per i metadati di database, schemi, tabelle e viste.

L'aggiornamento dei metadati per queste risorse dipende da quando è stato creato o ripristinato il cluster:

  • Quasi in tempo reale: i cluster creati o ripristinati a partire dal 3 aprile 2026 sincronizzano i metadati con Knowledge Catalog quasi in tempo reale. Gli aggiornamenti sono disponibili in Knowledge Catalog entro 5 minuti. In genere il processo di estrazione richiede alcuni secondi.

  • Ogni poche ore: i cluster creati o ripristinati tra il 26 febbraio 2026 e il 3 aprile 2026 aggiornano i metadati in Knowledge Catalog ogni poche ore. Gli aggiornamenti sono disponibili in Knowledge Catalog entro 48 ore. In genere, il processo di estrazione richiede alcuni minuti, ma il tempo di completamento dipende dalle dimensioni della CPU e dal numero di tabelle.

Crea AlloyDB con l'integrazione di Knowledge Catalog disabilitata

Puoi controllare questa integrazione quando crei o aggiorni un cluster utilizzando Google Cloud CLI o l'API AlloyDB:

gcloud

Utilizza il comando gcloud alloydb clusters create per creare un cluster AlloyDB. Se ometti il flag --enable-dataplex-integration, l'integrazione di Knowledge Catalog è abilitata per impostazione predefinita per i metadati di database, schema, tabella e vista. Per un elenco completo dei parametri di questa chiamata, consulta gcloud alloydb clusters create. Per informazioni sulle impostazioni del cluster, consulta Visualizza le impostazioni dei cluster e delle istanze.

Non includere informazioni sensibili o che consentono l'identificazione personale nell'ID cluster, perché l'ID cluster potrebbe essere visibile in vari contesti operativi, come log di sistema, dashboard di monitoraggio e comunicazioni di assistenza. Non è necessario includere l'ID progetto nel nome del cluster. Il sistema lo include automaticamente dove opportuno, ad esempio nei file di log.

Per disabilitare l'integrazione di Knowledge Catalog per le risorse di database, schema, tabella e vista, includi il flag --no-enable-dataplex-integration:

gcloud alloydb clusters create CLUSTER_ID \
    --password=PASSWORD \
    --region=REGION \
    --no-enable-dataplex-integration

Effettua le seguenti sostituzioni:

  • CLUSTER_ID: l'ID del cluster che crei. L'ID cluster deve iniziare con una lettera minuscola e può contenere lettere minuscole, numeri e trattini.
  • PASSWORD: la password che utilizzi per l'utente postgres predefinito.
  • REGION: l'ID della regione del cluster.

REST

Utilizza il metodo POST per creare un cluster AlloyDB. Se ometti dataplexConfig dalla richiesta, l'integrazione di Knowledge Catalog viene attivata per impostazione predefinita per i metadati di database, schema, tabella e visualizzazione. Per un elenco completo dei parametri di questa chiamata, consulta Metodo: projects.locations.clusters.create. Per informazioni sulle impostazioni del cluster, consulta Visualizza le impostazioni dei cluster e delle istanze.

Non includere informazioni sensibili o che consentono l'identificazione personale nell'ID cluster, perché l'ID cluster potrebbe essere visibile in vari contesti operativi, come log di sistema, dashboard di monitoraggio e comunicazioni di assistenza. Non è necessario includere l'ID progetto nel nome del cluster. Il sistema lo include automaticamente dove appropriato, ad esempio nei file di log.

Per disabilitare l'integrazione di Knowledge Catalog per le risorse di database, schema, tabella e vista, includi "dataplexConfig": { "enabled": false } nel corpo della richiesta:

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

Effettua le seguenti sostituzioni:

  • DATABASE_VERSION: stringa enum della versione del database, ad esempio POSTGRES_16.
  • INITIAL_USERNAME: il nome utente che utilizzi per l'utente postgres predefinito.
  • INITIAL_USER_PASSWORD: la password che utilizzi per l'utente postgres predefinito.

Utilizza il seguente metodo HTTP e il seguente URL:

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

Effettua le seguenti sostituzioni:

  • PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene il cluster.
  • LOCATION_ID: l'ID della regione del cluster.
  • CLUSTER_ID: l'ID del cluster che crei. L'ID cluster deve iniziare con una lettera minuscola e può contenere lettere minuscole, numeri e trattini.

Per inviare la richiesta, utilizza una delle seguenti opzioni:

curl (Linux, macOS o Cloud Shell)

Salva il corpo della richiesta in un file denominato request.json ed esegui questo comando:

    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)

Salva il corpo della richiesta in un file denominato request.json ed esegui questo comando:

$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

Ricevi una risposta JSON simile alla seguente:

Risposta

{
  "name": "projects/PROJECT_ID/locations/LOCATION_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.alloydb.v1.OperationMetadata",
    "createTime": "2024-09-25T22:19:33.735Z",
    "target": "projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Abilita l'integrazione di Knowledge Catalog per il tuo cluster AlloyDB

Per abilitare l'integrazione di Knowledge Catalog su un cluster esistente, utilizza una delle seguenti procedure:

gcloud

Per abilitare l'integrazione di Knowledge Catalog su un cluster esistente, utilizza il comando gcloud alloydb clusters update con il flag --enable-dataplex-integration.

gcloud alloydb clusters update CLUSTER_ID \
    --region=REGION \
    --enable-dataplex-integration

Effettua le seguenti sostituzioni:

  • CLUSTER_ID: il nome del cluster.
  • REGION: l'ID della regione del cluster.

REST

Per aggiornare campi specifici di un cluster esistente, utilizza il metodo PATCH su projects.locations.clusters resource.

Utilizza il seguente metodo HTTP e il seguente URL:

PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID?updateMask=dataplexConfig.enabled

Effettua le seguenti sostituzioni:

  • PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene il cluster.
  • LOCATION_ID: l'ID della regione del cluster.
  • CLUSTER_ID: il nome del cluster.

Corpo JSON della richiesta:

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

Per inviare la richiesta, utilizza una delle seguenti opzioni:

curl (Linux, macOS o Cloud Shell)

Salva il corpo della richiesta in un file denominato request.json ed esegui questo comando:

    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/locations/LOCATION_ID/clusters/CLUSTER_ID?updateMask=dataplexConfig.enabled"

PowerShell (Windows)

Salva il corpo della richiesta in un file denominato request.json ed esegui questo comando:

$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/locations/LOCATION_ID/clusters/CLUSTER_ID?updateMask=dataplexConfig.enabled"| Select-Object -Expand Content

Ricevi una risposta JSON simile alla seguente:

Risposta

{
  "name": "projects/PROJECT_ID/locations/LOCATION_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.alloydb.v1.OperationMetadata",
    "createTime": "2024-09-25T22:19:33.735Z",
    "target": "projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID",
    "verb": "update",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Verifica l'integrazione di Knowledge Catalog nel cluster AlloyDB

Per verificare che l'integrazione di Knowledge Catalog sia abilitata su un cluster esistente, utilizza una delle seguenti procedure:

gcloud

Per verificare che l'integrazione di Knowledge Catalog sia abilitata su un cluster esistente, utilizza il comando gcloud alloydb clusters describe.

gcloud alloydb clusters describe CLUSTER_ID --region=REGION

Effettua le seguenti sostituzioni:

  • CLUSTER_ID: l'ID cluster.
  • REGION: l'ID della regione del cluster.

L'output include la sezione dataplexConfig in formato YAML. Se enabled è true, l'integrazione di Knowledge Catalog è abilitata:

dataplexConfig:
  enabled: true

REST

Per verificare che l'integrazione di Knowledge Catalog sia abilitata su un cluster esistente, utilizza il metodo GET.

Utilizza il seguente metodo HTTP e il seguente URL:

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

Effettua le seguenti sostituzioni:

  • PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene il cluster.
  • LOCATION_ID: l'ID della regione del cluster.
  • CLUSTER_ID: l'ID cluster.

Per inviare la richiesta, utilizza una delle seguenti opzioni:

curl (Linux, macOS o Cloud Shell)

Salva il corpo della richiesta in un file denominato request.json ed esegui questo comando:

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

PowerShell (Windows)

Salva il corpo della richiesta in un file denominato request.json ed esegui questo comando:

$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/locations/LOCATION_ID/clusters/CLUSTER_ID"| Select-Object -Expand Content

Ricevi una risposta JSON per l'intero proto del cluster, che include il messaggio dataplexConfig:

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

Disattiva l'integrazione di Knowledge Catalog nel cluster AlloyDB

Quando disabiliti l'integrazione di Knowledge Catalog nel cluster AlloyDB, sono disponibili solo i metadati del cluster e dell'istanza.

gcloud

Utilizza il comando gcloud alloydb clusters update con il flag --no-enable-dataplex-integration per disattivare l'integrazione.

gcloud alloydb clusters update CLUSTER_ID \
    --region=REGION \
    --no-enable-dataplex-integration

Effettua le seguenti sostituzioni:

  • CLUSTER_ID: l'ID del cluster.
  • REGION: l'ID della regione del cluster.

REST

Utilizza l'esempio seguente per disattivare l'integrazione.

Utilizza il seguente metodo HTTP e il seguente URL:

PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID?updateMask=dataplexConfig.enabled

Effettua le seguenti sostituzioni:

  • PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene il cluster.
  • LOCATION_ID: l'ID della regione del cluster.
  • CLUSTER_ID: l'ID cluster.

Corpo JSON della richiesta:

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

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Salva il corpo della richiesta in un file denominato request.json ed esegui questo comando:

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/locations/LOCATION_ID/clusters/CLUSTER_ID?updateMask=dataplexConfig.enabled"

PowerShell (Windows)

Salva il corpo della richiesta in un file denominato request.json ed esegui questo comando:

$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/locations/LOCATION_ID/clusters/CLUSTER_ID?updateMask=dataplexConfig.enabled"| Select-Object -Expand Content

Ricevi una risposta JSON simile alla seguente:

Risposta

{
  "name": "projects/PROJECT_ID/locations/LOCATION_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.alloydb.v1.OperationMetadata",
    "createTime": "2024-01-16T02:32:12.281Z",
    "target": "projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID",
    "verb": "update",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Arricchisci gli asset AlloyDB con gli aspetti

I tipi di aspetto sono risorse riutilizzabili che fungono da modelli per gli aspetti. I tipi di aspetto aiutano a evitare di duplicare il lavoro e di creare aspetti incompleti. Crea i tipi di aspetto necessari utilizzando Knowledge Catalog.

Dopo aver creato i tipi di aspetto personalizzati, associa gli aspetti agli asset AlloyDB. Il collegamento di aspetti agli asset AlloyDB offre le seguenti funzionalità:

  • Aggiungi metadati aziendali agli asset
  • Cerca asset in base ai metadati aziendali e ad altri metadati personalizzati

Per scoprire di più sulla creazione di tipi di aspetti e sul collegamento di aspetti ad AlloyDB, consulta Gestisci gli aspetti e arricchisci i metadati.

Cerca asset AlloyDB

Utilizza la pagina di ricerca di Knowledge Catalog nella console Google Cloud per cercare gli asset AlloyDB.

  1. Vai alla pagina Ricerca di Knowledge Catalog.

    Vai alla Ricerca

  2. In Scegli la piattaforma di ricerca, seleziona Knowledge Catalog.

  3. Nel riquadro Filtri, fai clic su Sistemi e poi seleziona AlloyDB.

  4. Facoltativo. In Alias tipo, filtra i risultati di ricerca in base a un tipo specifico di asset AlloyDB selezionando uno o più dei seguenti alias tipo:

    • Database
    • Schema del database
    • Cluster
    • Istanza
    • Servizio
    • Tabella
    • Visualizza

Utilizza il campo di ricerca in Knowledge Catalog per eseguire query di ricerca per parole chiave. Ad esempio, inserisci system=AlloyDB AND type=Database per visualizzare tutti i database AlloyDB.

Per saperne di più, consulta Sintassi di ricerca per Knowledge Catalog.

Per visualizzare tutti gli asset AlloyDB, inserisci system=AlloyDB.

Poi inserisci parole chiave specifiche. Ad esempio, per visualizzare tutti i database AlloyDB:

system=AlloyDB AND type=Database

Per visualizzare tutte le tabelle AlloyDB, inserisci la seguente query:

system=AlloyDB AND type=Table

Puoi anche utilizzare le parentesi e gli operatori logici AND e OR per espressioni complesse. Per saperne di più sulle espressioni che puoi utilizzare nel campo di ricerca, consulta Sintassi di ricerca per Knowledge Catalog.

Puoi inserire direttamente le query di ricerca per asset AlloyDB specifici nel campo di ricerca. Il formato della stringa di query è il seguente:

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

Sostituisci quanto segue:

  • QUERY_STRING: utilizza il seguente elenco per identificare una stringa di query in base al tipo di asset AlloyDB su cui vuoi eseguire query:

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

Una query di esempio potrebbe essere simile alla seguente:

type="projects/dataplex-types/locations/global/entryTypes/alloydb-cluster"

Cerca per tipo di aspetto

Knowledge Catalog include alcuni tipi di aspetto integrati che ti aiutano a eseguire le ricerche.

Per eseguire una ricerca in base al tipo di aspetto, segui questi passaggi:

  1. Nel riquadro Aspetti, fai clic sul menu Aggiungi altri tipi di aspetti.
  2. Facoltativo. Seleziona Accesso ad AlloyDB per filtrare i risultati in base al dialetto AlloyDB.
  3. Seleziona uno o più dei seguenti tipi di aspetto per limitare i risultati di ricerca a quel tipo.
    • Database AlloyDB
    • Cluster AlloyDB
    • Istanza AlloyDB
    • Vista AlloyDB
    • Schema AlloyDB
    • Tabella AlloyDB
  4. Fai clic su OK.
  5. Nella tabella dei risultati, fai clic sul nome della risorsa per visualizzarne i metadati.
  6. (Facoltativo) Migliora o visualizza gli asset. Puoi migliorare o visualizzare i tuoi asset nei seguenti modi:
    • Per aggiungere una descrizione in RTF dell'asset, fai clic su Aggiungi in Panoramica.
    • Per collegare un aspetto all'asset, fai clic su Aggiungi in Aspetti.
    • Per visualizzare i database membri di un'istanza, fai clic sulla scheda Elenco voci, quindi su Mostra tutte le voci secondarie nella ricerca. Se la scheda Elenco voci non viene visualizzata, significa che il cluster non contiene database.
    • Visualizza i dettagli completi dell'asset in Dettagli voce. Fai clic sul nome della voce per visualizzare altre voci.

Ricerca in linguaggio naturale in AlloyDB

La ricerca in linguaggio naturale utilizza l'AI per comprendere le query semantiche. Ti aiuta a trovare le risorse utilizzando un linguaggio naturale, eliminando la necessità di una sintassi complessa. Ad esempio, inserisci query come List all AlloyDB tables related to sales.

Per saperne di più, consulta Sintassi di ricerca per Knowledge Catalog.

Ricerca della sintassi in AlloyDB

La ricerca per parole chiave ti aiuta a trovare le risorse utilizzando parole chiave specifiche, filtri e una sintassi definita. Ad esempio, inserisci system=AlloyDB AND type=Database per visualizzare tutti i database AlloyDB.

Per saperne di più, consulta Sintassi di ricerca per Knowledge Catalog.

Esempio di workflow: visualizza i dettagli dal cluster alle colonne

Per eseguire il drill-down dal cluster alle colonne:

  1. Vai alla pagina Ricerca di Knowledge Catalog.

    Vai alla Ricerca

  2. Per l'opzione Scegli la piattaforma di ricerca, seleziona Knowledge Catalog.

  3. Nel riquadro Filtri, seleziona Sistemi e poi AlloyDB. In alternativa, inserisci system=AlloyDB nel campo di ricerca.

  4. Seleziona un nome per il cluster.

  5. Nella pagina Dettagli AlloyDB, fai clic sulla scheda Elenco voci, quindi su Mostra tutte le voci secondarie nella ricerca. Knowledge Catalog mostra i database nel cluster.

  6. Nella pagina Dettagli del database AlloyDB, fai clic sulla scheda Elenco voci, quindi su Visualizza le voci secondarie nella ricerca. Knowledge Catalog visualizza le tabelle nel cluster.

  7. Seleziona un nome di tabella, quindi nella pagina Dettagli tabella AlloyDB, fai clic su Schema per visualizzare le colonne della tabella.

  8. (Facoltativo) Per aggiungere un tipo di aspetto a una colonna, fai clic sul pulsante Aggiungi aspetto.

Prezzi

Non sono previsti costi per l'archiviazione dei metadati tecnici di AlloyDB in Knowledge Catalog. Per le chiamate API e l'arricchimento aggiuntivo dei metadati aziendali si applicano i prezzi standard di Knowledge Catalog. Per saperne di più, consulta la pagina dei prezzi di Knowledge Catalog.

Utilizzo delle risorse

Knowledge Catalog estrae periodicamente i metadati dai cluster AlloyDB. Questo processo di estrazione consuma risorse della CPU nel cluster. L'utilizzo della CPU è generalmente minimo. Ad esempio, i cluster con tipi di macchine più piccoli (come n2-highmem-2-icelake) che gestiscono schemi di grandi dimensioni (come quelli con 100.000 o più tabelle) potrebbero registrare un aumento dell'utilizzo della CPU fino al 5% durante l'estrazione.

Limitazioni

  • L'integrazione supporta un massimo di un milione di tabelle per database e una media di 150 colonne per tabella. Se uno di questi limiti viene superato, i metadati per risorse come database, schemi, tabelle e viste non vengono estratti. In Knowledge Catalog sono disponibili solo i metadati del cluster e dell'istanza.
  • Quando viene creato un cluster, la sincronizzazione iniziale di tutti i metadati con Knowledge Catalog può richiedere fino a 48 ore. Dopo la sincronizzazione iniziale, gli aggiornamenti successivi sono disponibili quasi in tempo reale.
  • In caso di un tasso elevato di modifiche ai metadati (oltre 100 o più modifiche DDL al secondo) nel database, la sincronizzazione dei metadati quasi in tempo reale con Knowledge Catalog potrebbe essere messa in pausa per un massimo di 30 minuti prima di riprendere.
  • Se un aggiornamento non viene eseguito a causa di un tasso elevato di modifiche ai metadati, di problemi di rete o dell'interruzione del processo di sincronizzazione, diventa visibile in Knowledge Catalog entro 48 ore.
  • Se un'istanza non esiste o non è in esecuzione, l'eliminazione dei metadati può richiedere 7 giorni.
  • Quando un database viene rinominato, solo l'aggiornamento del database è disponibile in Knowledge Catalog quasi in tempo reale. La mappatura sottostante del database e tutte le rispettive tabelle verranno aggiornate in Knowledge Catalog entro 48 ore.

Passaggi successivi