Gestisci le risorse AlloyDB utilizzando Knowledge Catalog

L'integrazione di Knowledge Catalog è attivata per impostazione predefinita per tutti i nuovi cluster AlloyDB, consentendoti di cercare e gestire le 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:comprendi le dipendenze e valuta l'idoneità per vari casi d'uso.
Gestione delle modifiche: monitora e gestisci in modo efficace le modifiche ai metadati.
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 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

Tipi di rilevamento dei metadati

L'individuazione 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. Successivamente, 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 di cluster e istanze vengono rilevati per impostazione predefinita. Il rilevamento dei metadati di database, schemi, tabelle e viste è attivato per impostazione predefinita sui nuovi cluster. Per i cluster creati prima dell'implementazione di questo valore predefinito (26 febbraio 2026), attiva manualmente l'integrazione.

Ricerca per parola chiave e in linguaggio naturale

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

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

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

Esempio: individuazione 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 primaria di questo cluster esiste un database denominato profiles, che contiene una tabella customers (id, email, signup_date) e una visualizzazione 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 (customerstabella e active_users) nella pagina Knowledge Catalog della console Google Cloud o utilizzando l'API. Poi, visualizza i relativi schemi e arricchiscili con metadati aziendali o operativi aggiuntivi.

Arricchire 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 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. L'associazione di aspetti agli asset AlloyDB consente di:

Aggiungi i metadati aziendali agli asset.
Cerca risorse in base ai metadati aziendali e ad altri metadati personalizzati.

Per scoprire di più sulla creazione di tipi di aspetto e sull'allegato di aspetti ad AlloyDB, consulta Gestire gli aspetti e arricchire i metadati.

Flusso di lavoro di rilevamento dei metadati

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

Abilita l'integrazione di Knowledge Catalog per il tuo cluster AlloyDB utilizzando l'API AlloyDB se non è già abilitata. Questo è necessario per i cluster creati prima del 26 febbraio 2026.
Cerca gli asset AlloyDB utilizzando la pagina di ricerca Knowledge Catalog nella console Google Cloud . Per saperne di più, consulta Cercare risorse in Knowledge Catalog.
Per aggiungere più contesto agli asset AlloyDB, collega aspetti agli asset. Gli aspetti sono voci di metadati personalizzate che aiutano la governance dei dati e l'analisi. Ad esempio, utilizza un aspetto per etichettare una colonna che contiene informazioni che consentono l'identificazione personale (PII). Per saperne di più, consulta Gestire gli aspetti e arricchire i metadati.
Esplora le risorse AlloyDB seguendo questa gerarchia: Cluster > Database > Schema > Tabella o Vista > Colonna. Questa gerarchia fornisce una visualizzazione dettagliata del tuo panorama dei dati. Per saperne di più, consulta Cercare risorse in Knowledge Catalog.

Prima di iniziare

Accedi al tuo account Google Cloud . Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei workload.

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

Verify that billing is enabled for your Google Cloud project.

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

Verify that billing is enabled for your Google Cloud project.

Abilita l'API Dataplex per il progetto.

Abilitare l'API Dataplex
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 per accedere ai risultati di ricerca.

Ruoli richiesti per accedere ai risultati di ricerca

Per cercare e visualizzare i metadati AlloyDB in Knowledge Catalog, i principal richiedono le autorizzazioni per visualizzare le risorse AlloyDB, inclusa l'autorizzazione dataplex.projects.search.

Per concedere queste autorizzazioni ai principal, come utenti, gruppi o service account, assegna loro il ruolo IAM Visualizzatore AlloyDB (roles/alloydb.viewer) nel progetto che contiene le risorse AlloyDB.

Operazione Knowledge Catalog	Risorsa AlloyDB	Ruoli o autorizzazioni richiesti
Cercare 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 predefinito Visualizzatore AlloyDB, 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 Gestire 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:

Dataplex Catalog Admin (roles/dataplex.catalogAdmin)
Dataplex Catalog Editor (roles/dataplex.catalogEditor)
Dataplex Catalog Viewer (roles/dataplex.catalogViewer)

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

Aggiornamento dei dati di integrazione di Knowledge Catalog

Per impostazione predefinita, Knowledge Catalog acquisisce e rileva le risorse del cluster e dell'istanza e la loro freschezza dei metadati è quasi in tempo reale.

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

L'attivazione 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, schema, tabella e vista.

La freschezza dei metadati per queste risorse dipende dalla data di creazione o ripristino del 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 nel catalogo della conoscenza 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 nel catalogo della conoscenza 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 per questa chiamata, vedi gcloud alloydb clusters create. Per informazioni sulle impostazioni del cluster, vedi Visualizzare le impostazioni dei cluster e delle istanze.

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

Per disattivare 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 vista. Per un elenco completo dei parametri per questa chiamata, consulta Metodo: projects.locations.clusters.create. Per informazioni sulle impostazioni del cluster, vedi Visualizzare le impostazioni dei cluster e delle istanze.

Per disattivare 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 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 il comando seguente:

    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 il comando seguente:

$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

{
  "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"
}

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

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

gcloud

Per attivare l'integrazione di Knowledge Catalog in 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 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 il comando seguente:

    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 il comando seguente:

$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

{
  "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"
}

Verifica l'integrazione di Knowledge Catalog nel tuo 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 in un cluster esistente, utilizza il metodo GET.

Utilizza il seguente metodo HTTP e 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 il comando seguente:

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 il comando seguente:

$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 Cluster, che include il messaggio dataplexConfig:

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

Disattiva l'integrazione di Knowledge Catalog nel tuo 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 il seguente esempio per disattivare l'integrazione.

Utilizza il seguente metodo HTTP e 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 il comando seguente:

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 il comando seguente:

$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

{
  "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"
}

Arricchisci gli asset AlloyDB con gli aspetti

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

Aggiungere metadati aziendali agli asset
Cercare asset in base ai metadati aziendali e ad altri metadati personalizzati

Per scoprire di più sulla creazione di tipi di aspetto e sull'allegato di aspetti ad AlloyDB, consulta Gestire gli aspetti e arricchire i metadati.

Cerca asset AlloyDB

Utilizza la pagina di ricerca del catalogo della conoscenza nella console Google Cloud per cercare asset AlloyDB.

Vai alla pagina Ricerca del catalogo delle conoscenze.

Vai a Cerca
In Scegli la piattaforma di ricerca, seleziona Knowledge Catalog.
Nel riquadro Filtri, fai clic su Sistemi, quindi seleziona AlloyDB.
Facoltativo. In Alias dei tipi, filtra i risultati di ricerca in base a un tipo specifico di asset AlloyDB selezionando uno o più dei seguenti alias dei tipi:
- Database
- Schema del database
- Cluster
- Istanza
- Servizio
- Tabella
- Visualizza
Nota:Service è un alias di tipo per un'istanza AlloyDB.

Utilizzare le query per eseguire la ricerca per parola chiave

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ù, vedi 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 che vuoi interrogare:
- alloydb-database
- alloydb-cluster
- alloydb-instance
- alloydb-table
- alloydb-schema
- alloydb-view

Una query di esempio potrebbe avere il seguente aspetto:

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

Cercare per tipo di aspetto

Il catalogo della conoscenza include alcuni tipi di aspetti integrati che ti aiutano a eseguire le ricerche.

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

Nel riquadro Aspetti, fai clic sul menu Aggiungi altri tipi di aspetti.
Facoltativo. Seleziona AlloyDB Access per filtrare i risultati in base al dialetto AlloyDB.
Seleziona uno o più dei seguenti tipi di aspetto per limitare i risultati della ricerca a quel tipo.
- Database AlloyDB
- Cluster AlloyDB
- Istanza AlloyDB
- Visualizzazione AlloyDB
- Schema AlloyDB
- Tabella AlloyDB
Fai clic su OK.
Nella tabella dei risultati, fai clic sul nome della risorsa per visualizzarne i metadati.
(Facoltativo) Migliora o visualizza gli asset. Puoi migliorare o visualizzare i tuoi asset nei seguenti modi:
- Per aggiungere una descrizione in formato RTF dell'asset, fai clic su Aggiungi in Panoramica.
- Per allegare un aspetto all'asset, fai clic su Aggiungi in Aspetti.
- Per visualizzare i database dei membri di un'istanza, fai clic sulla scheda Elenco voci, quindi fai clic su Mostra tutte le voci secondarie nella ricerca. Se la scheda Elenco voci non viene visualizzata, il cluster non ha database.
- Visualizza tutti i dettagli dell'asset in Dettagli voce. Fai clic sul nome della voce per visualizzare in dettaglio ulteriori voci.

Ricerca in linguaggio naturale in AlloyDB

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

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

Ricerca della sintassi in AlloyDB

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

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

Workflow di esempio: visualizzare in dettaglio dal cluster alle colonne

Per visualizzare in dettaglio dal cluster alle colonne:

Vai alla pagina Ricerca del catalogo delle conoscenze.

Vai a Cerca
Per l'opzione Scegli la piattaforma di ricerca, seleziona Knowledge Catalog.
Nel riquadro Filtri, seleziona Sistemi e poi AlloyDB. In alternativa, inserisci system=AlloyDB nel campo di ricerca.
Seleziona un nome del cluster.
Nella pagina Dettagli AlloyDB, fai clic sulla scheda Elenco voci e poi su Mostra tutte le voci secondarie nella ricerca. Knowledge Catalog mostra i database nel cluster.

Nota: se la scheda Elenco voci non viene visualizzata, torna alla pagina Cerca e scegli un altro cluster.
Nella pagina Dettagli database AlloyDB, fai clic sulla scheda Elenco voci, quindi su Visualizza voci secondarie nella ricerca. Il catalogo delle conoscenze mostra le tabelle nel cluster.
Seleziona un nome di tabella, quindi nella pagina Dettagli tabella AlloyDB, fai clic su Schema per visualizzare le colonne della tabella.
(Facoltativo) Per aggiungere un tipo di aspetto a una colonna, fai clic sul pulsante Aggiungi aspetto.

Prezzi

Non è previsto alcun costo per l'archiviazione dei metadati tecnici di AlloyDB in Knowledge Catalog. Per le chiamate API e l'arricchimento dei metadati aziendali aggiuntivi si applicano i prezzi standard di Knowledge Catalog. Per ulteriori informazioni, consulta la pagina dei prezzi di Knowledge Catalog.

Utilizzo delle risorse

Knowledge Catalog estrae periodicamente i metadati dai tuoi cluster AlloyDB. Questo processo di estrazione consuma risorse della CPU sul 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 di cluster e istanze.
Quando viene creato un cluster per la prima volta, 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 elevato tasso di modifiche ai metadati (oltre 100 modifiche DDL al secondo) nel database, la sincronizzazione dei metadati quasi in tempo reale con Knowledge Catalog potrebbe essere sospesa fino a 30 minuti prima di riprendere.
Se un aggiornamento viene perso a causa dell'elevato tasso di modifiche ai metadati, di problemi di rete o dell'interruzione del processo di sincronizzazione, alla fine diventa visibile nel catalogo delle conoscenze entro 48 ore.
Quando un'istanza non esiste o non è in esecuzione, possono essere necessari 7 giorni prima che i metadati vengano eliminati.
Quando un database viene rinominato, solo l'aggiornamento del database è disponibile in Knowledge Catalog quasi in tempo reale. La mappatura sottostante del database e di tutte le tabelle corrispondenti verrà aggiornata in Knowledge Catalog entro 48 ore.

Gestisci le risorse AlloyDB utilizzando Knowledge Catalog Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Tipi di rilevamento dei metadati

Ricerca per parola chiave e in linguaggio naturale

Esempio: individuazione di uno schema di database AlloyDB

Arricchire i metadati utilizzando gli aspetti

Flusso di lavoro di rilevamento dei metadati

Prima di iniziare

Ruoli IAM richiesti

Ruoli richiesti per accedere ai risultati di ricerca

Ruoli obbligatori per la ricerca di voci

Aggiornamento dei dati di integrazione di Knowledge Catalog

Crea AlloyDB con l'integrazione di Knowledge Catalog disabilitata

gcloud

REST

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Risposta

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

gcloud

REST

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Risposta

Verifica l'integrazione di Knowledge Catalog nel tuo cluster AlloyDB

gcloud

REST

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Disattiva l'integrazione di Knowledge Catalog nel tuo cluster AlloyDB

gcloud

REST

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Risposta

Arricchisci gli asset AlloyDB con gli aspetti

Cerca asset AlloyDB

Utilizzare le query per eseguire la ricerca per parola chiave

Cercare per tipo di aspetto

Ricerca in linguaggio naturale in AlloyDB

Ricerca della sintassi in AlloyDB

Workflow di esempio: visualizzare in dettaglio dal cluster alle colonne

Prezzi

Utilizzo delle risorse

Limitazioni

Passaggi successivi

Gestisci le risorse AlloyDB utilizzando Knowledge Catalog