Gestisci le risorse Cloud SQL utilizzando Knowledge Catalog

Questa pagina spiega come cercare e gestire le risorse Cloud SQL utilizzando Knowledge Catalog.

Knowledge Catalog è una piattaforma per archiviare, gestire e accedere ai tuoi metadati. Knowledge Catalog recupera automaticamente i seguenti metadati da istanze, database, tabelle, colonne e viste Cloud SQL:

  • Nome
  • Località (regione)
  • Data di creazione e data dell'ultima modifica
  • Schema (per tabelle e viste)
  • Descrizione
  • Vincoli di chiave primaria e chiave esterna

Knowledge Catalog recupera i metadati solo dalle istanze principali di Cloud SQL e non dalle repliche di lettura o dalle repliche del server esterno.

Puoi utilizzare Knowledge Catalog per scoprire e comprendere i metadati di Cloud SQL. Utilizza Knowledge Catalog per facilitare le seguenti attività:

  • Rilevamento dati
  • Classificazione
  • Analisi, incluse le dipendenze e l'idoneità per un caso d'uso
  • Gestione dei cambiamenti
  • Spostamento dei dati (pipeline)
  • Evoluzione dello schema

Con Knowledge Catalog, puoi curare i metadati collegando gli aspetti alle voci dei metadati di Cloud SQL. Ogni aspetto può avere più campi di metadati e può basarsi su un tipo di aspetto predefinito o personalizzato.

Ad esempio, puoi collegare il seguente aspetto a una colonna che contiene un numero di previdenza sociale, che è un'informazione che consente l'identificazione personale (PII):

  pii:true
  pii_type:SSN

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

Aggiornamento dei dati di integrazione di Knowledge Catalog

L'aggiornamento previsto dei metadati dell'istanza in Knowledge Catalog dipende dalla data di creazione dell'istanza e dalla versione del database.

Quasi in tempo reale

L'integrazione con Knowledge Catalog è abilitata per impostazione predefinita quando viene creata l'istanza se questa soddisfa tutti i seguenti criteri:

  1. Data di creazione: a partire dal 18 aprile 2026

  2. Versione:Cloud SQL per PostgreSQL versione 14.0 o successive
  3. Architettura di rete: nuova architettura di rete

Se la tua istanza non soddisfa tutti questi criteri, consulta Una volta al giorno.

Vengono create istanze che soddisfano tutti questi criteri e contengono una tabella dei timestamp per monitorare gli orari di creazione e aggiornamento delle risorse. La tabella dei timestamp si trova nel database cloudsqladmin. Quando l'istanza subisce una modifica di DDL o dello schema, l'integrazione esegue query sulla tabella dei timestamp per identificare gli asset modificati di recente, quindi carica gli aggiornamenti dello schema più recenti in Knowledge Catalog quasi in tempo reale. In rari casi, ad esempio in caso di instabilità della rete, Knowledge Catalog potrebbe perdere un aggiornamento. Anche se è raro, le modifiche che non sono state rilevate diventano alla fine coerenti, in genere entro 24 ore. Per ulteriori informazioni sugli scenari che possono causare modifiche mancanti, consulta Limitazioni in questa pagina.

Quando visualizzi le query eseguite in un'istanza, vedrai le query che supportano l'integrazione di Knowledge Catalog. Puoi identificare queste query dal commento --Dataplex che includono. Per visualizzare le query per un'istanza, consulta Visualizza query attive.

Puoi disattivare l'integrazione e riattivarla in un secondo momento seguendo le istruzioni riportate in Aggiornare l'istanza.

Una volta al giorno

L'integrazione con Knowledge Catalog può essere abilitata per le istanze che soddisfano uno dei seguenti criteri:

  1. Data di creazione: prima del 18 aprile 2026
  2. Versione:Cloud SQL per PostgreSQL versione precedente alla 14.0
  3. Architettura di rete: vecchia architettura di rete

Se la tua istanza è stata creata dopo il 18 aprile 2026, l'integrazione con Knowledge Catalog è abilitata per impostazione predefinita. Per le istanze create prima del 18 aprile 2026, puoi abilitare l'integrazione di Knowledge Catalog in un'istanza Cloud SQL esistente .

Dopo aver abilitato l'integrazione con Knowledge Catalog, i metadati delle istanze che soddisfano uno di questi criteri vengono in genere aggiornati in Knowledge Catalog circa una volta al giorno. Puoi disattivare l'integrazione di Knowledge Catalog e riattivarla in base alle esigenze.

Prima di iniziare

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

  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. Abilita l'API Dataplex per il progetto.

    Abilitare l'API Dataplex

  7. Controlla le autorizzazioni.

    Per cercare e allegare voci agli asset Cloud SQL, devi disporre di determinati ruoli e autorizzazioni Identity and Access Management (IAM). Per maggiori dettagli, vedi Ruoli e autorizzazioni IAM richiesti per Knowledge Catalog.

Ruoli e autorizzazioni IAM richiesti per Knowledge Catalog

Cloud SQL utilizza l'autorizzazione cloudsql.schemas.view per fornire l'accesso ai metadati in Knowledge Catalog.

Per fornire questa autorizzazione, crea un ruolo personalizzato che la includa o utilizza uno dei ruoli predefiniti che la dispongono.

Per saperne di più, consulta Ruoli Cloud IAM predefiniti di Cloud SQL.

Crea un'istanza con l'integrazione di Knowledge Catalog abilitata

Le nuove istanze sono integrate con Knowledge Catalog per impostazione predefinita. Per creare una nuova istanza con l'integrazione di Knowledge Catalog abilitata, devi solo creare una nuova istanza. Per creare un'istanza con Knowledge Catalog integrato in quasi in tempo reale, la nuova istanza deve soddisfare tutti i seguenti criteri:

  1. Data di creazione: a partire dal 18 aprile 2026

  2. Versione:Cloud SQL per PostgreSQL versione 14.0 o successive
  3. Architettura di rete: nuova architettura di rete

Se vuoi attivare Knowledge Catalog quasi in tempo reale per una nuova istanza con una versione precedente del database o la vecchia architettura di rete, puoi clonare l'istanza o eseguire il ripristino da un backup in una nuova istanza.

gcloud

Crea l'istanza

Per creare un'istanza Cloud SQL, utilizza il comando gcloud sql instances create.

gcloud sql instances create INSTANCE_NAME \
  --database-version=DATABASE_VERSION \
  --tier=MACHINE_TYPE \
  --region=REGION_NAME

Effettua le seguenti sostituzioni:

  • INSTANCE_NAME: il nome dell'istanza
  • DATABASE_VERSION: la versione del database per l'istanza (ad esempio, POSTGRES_14 ). Per un elenco completo delle stringhe disponibili, consulta SqlDatabaseVersion
  • MACHINE_TYPE: il tipo di macchina per l'istanza
  • REGION_NAME: il nome della regione dell'istanza

Questo esempio è basato su Linux.

REST v1

Crea l'istanza

Utilizza questo esempio per creare un'istanza con l'integrazione attivata. Per un elenco completo dei parametri disponibili per questa chiamata, consulta la pagina instances.insert.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza
  • INSTANCE_NAME: il nome dell'istanza
  • REGION_NAME: il nome della regione dell'istanza
  • DATABASE_VERSION: stringa enum della versione del database (ad esempio POSTGRES_13). Per un elenco completo delle stringhe disponibili, vedi SqlDatabaseVersion.
  • PASSWORD: la password per l'utente root
  • MACHINE_TYPE: stringa enum del tipo di macchina (livello), come: db-custom-[CPUS]-[MEMORY_MBS]
  • EDITION_TYPE: la tua versione di Cloud SQL

Metodo HTTP e URL: 

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances

Corpo JSON della richiesta: 

{
  "name": "INSTANCE_NAME",
  "region": "REGION_NAME",
  "databaseVersion": "DATABASE_VERSION",
  "rootPassword": "PASSWORD",
  "settings": {
    "tier": "MACHINE_TYPE",
    "edition": "EDITION_TYPE",
    "enableDataplexIntegration": true
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

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

REST v1beta4

Crea l'istanza

Utilizza questo esempio per creare un'istanza con l'integrazione attivata. Per un elenco completo dei parametri disponibili per questa chiamata, consulta la pagina instances.insert.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza
  • INSTANCE_NAME: il nome dell'istanza
  • REGION_NAME: il nome della regione dell'istanza
  • DATABASE_VERSION: stringa enum della versione del database (ad esempio, POSTGRES_13). Per un elenco completo delle stringhe disponibili, vedi SqlDatabaseVersion.
  • PASSWORD: la password per l'utente root
  • MACHINE_TYPE: stringa enum del tipo di macchina (livello), come: db-custom-[CPUS]-[MEMORY_MBS]
  • EDITION_TYPE: la tua versione di Cloud SQL

Metodo HTTP e URL: 

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances

Corpo JSON della richiesta: 

{
  "name": "INSTANCE_NAME",
  "region": "REGION_NAME",
  "databaseVersion": "DATABASE_VERSION",
  "rootPassword": "PASSWORD",
  "settings": {
    "tier": "MACHINE_TYPE",
    "edition": "EDITION_TYPE",
    "enableDataplexIntegration": true
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

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

Abilita l'integrazione di Knowledge Catalog su un'istanza Cloud SQL esistente

Questa sezione si applica alle istanze che soddisfano uno dei seguenti criteri:
  1. Data di creazione: prima del 18 aprile 2026
  2. Versione:Cloud SQL per PostgreSQL versione precedente alla 14.0
  3. Architettura di rete: vecchia architettura di rete

Puoi anche seguire le istruzioni di aggiornamento in questa sezione per riattivare l'integrazione di Knowledge Catalog in un'istanza precedentemente integrata con Knowledge Catalog quasi in tempo reale. Dopo la riattivazione dell'integrazione, possono essere necessari fino a 10 minuti prima che i dati quasi in tempo reale inizino a essere visualizzati in Knowledge Catalog.

Per attivare o riattivare l'integrazione di Knowledge Catalog in un'istanza Cloud SQL esistente, utilizza una delle seguenti procedure.

gcloud

Aggiorna l'istanza

Per attivare l'integrazione per un'istanza esistente, utilizza il comando gcloud sql instances patch.

gcloud sql instances patch INSTANCE_NAME \
  --enable-dataplex-integration

Se devi abilitare e aggiornare tutte le istanze Cloud SQL nel tuo progetto, puoi eseguire uno script simile al seguente:

gcloud sql instances list --format="(NAME)" \
| tail -n +2 | xargs -t -I %
gcloud sql instances patch % --enable-dataplex-integration

Questo esempio è basato su Linux.

REST v1

Aggiorna l'istanza

Utilizza questo esempio per aggiornare un'istanza esistente. Per un elenco completo dei parametri disponibili per questa chiamata, consulta la pagina instances.patch.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza
  • INSTANCE_NAME: il nome dell'istanza

Metodo HTTP e URL: 

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

Corpo JSON della richiesta: 

{
  "settings":
  {
    "enableDataplexIntegration": true
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

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

REST v1beta4

Aggiorna l'istanza

Utilizza questo esempio per aggiornare un'istanza esistente. Per un elenco completo dei parametri disponibili per questa chiamata, consulta la pagina instances.patch.

Utilizza questo esempio per aggiornare un'istanza esistente. Per un elenco completo dei parametri disponibili per questa chiamata, consulta la pagina instances.patch.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza
  • INSTANCE_NAME: il nome dell'istanza

Metodo HTTP e URL: 

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

Corpo JSON della richiesta: 

{
  "settings":
  {
    "enableDataplexIntegration": true
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

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

Verifica l'integrazione di Knowledge Catalog nell'istanza Cloud SQL

Per verificare che l'integrazione di Knowledge Catalog sia abilitata nella tua istanza, utilizza una delle seguenti procedure.

gcloud

Per verificare che l'integrazione di Knowledge Catalog sia abilitata in un'istanza esistente, utilizza il comando gcloud sql instances describe.

gcloud sql instances describe INSTANCE_NAME

Sostituisci INSTANCE_NAME con il nome dell'istanza. Nell'output, cerca l'impostazione di configurazione enableDataplexIntegration impostata su true.

REST v1

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • PROJECT_ID: l'ID progetto
  • INSTANCE_ID: l'ID istanza

Metodo HTTP e URL: 

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
"settings":
  {
  "enableDataplexIntegration": true
  }
}

REST v1beta4

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • PROJECT_ID: l'ID progetto
  • INSTANCE_ID: l'ID istanza

Metodo HTTP e URL: 

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
"settings":
  {
  "enableDataplexIntegration": true
  }
}

Disattiva l'integrazione di Knowledge Catalog nell'istanza Cloud SQL

Per disattivare l'integrazione di Knowledge Catalog nell'istanza Cloud SQL, utilizza una delle seguenti procedure. La disattivazione dell'integrazione di Knowledge Catalog in un'istanza integrata quasi in tempo reale richiede fino a 10 minuti.

Console

  1. Nella console Google Cloud , vai alla pagina Istanze Cloud SQL.

    Vai a Istanze Cloud SQL

  2. Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
  3. Fai clic su Modifica.
  4. Nella sezione Personalizza la tua istanza, espandi il menu Mostra opzioni di configurazione.

  5. Nella sezione Flag e parametri, deseleziona la casella di controllo Abilita l'integrazione di Knowledge Catalog.

  6. Fai clic su Salva.

gcloud

Per disattivare l'integrazione per un'istanza esistente, utilizza il comando gcloud sql instances patch.

gcloud sql instances patch INSTANCE_NAME \
  --no-enable-dataplex-integration

Se devi disattivare l'integrazione e aggiornare tutte le istanze Cloud SQL nel tuo progetto, puoi eseguire uno script simile al seguente:

gcloud sql instances list --format="(NAME)" \
| tail -n +2 | xargs -t -I %
gcloud sql instances patch % --no-enable-dataplex-integration

Questo esempio è basato su Linux.

REST v1

Utilizza questo esempio per disattivare l'integrazione.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza
  • INSTANCE_NAME: il nome dell'istanza

Metodo HTTP e URL: 

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

Corpo JSON della richiesta: 

{
  "settings":
  {
    "enableDataplexIntegration": false
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

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

REST v1beta4

Utilizza questo esempio per disattivare l'integrazione.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza
  • INSTANCE_NAME: il nome dell'istanza

Metodo HTTP e URL: 

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

Corpo JSON della richiesta: 

{
  "settings":
  {
    "enableDataplexIntegration": false
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

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

Arricchisci gli asset Cloud SQL con gli aspetti

I tipi di aspetto sono risorse riutilizzabili che puoi utilizzare come modelli per gli aspetti. I tipi di aspetto ti aiutano a evitare la duplicazione del lavoro e gli aspetti incompleti. Puoi utilizzare Knowledge Catalog per creare i tipi di aspetto di cui hai bisogno.

Dopo aver creato tipi di aspetti personalizzati, puoi collegare gli aspetti agli asset Cloud SQL. Il collegamento di aspetti agli asset Cloud SQL ti consente di:

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

Per scoprire di più su come creare tipi di aspetto e collegare aspetti a Cloud SQL, consulta Gestire gli aspetti e arricchire i metadati.

Cercare asset Cloud SQL

Utilizza la pagina di ricerca del catalogo delle conoscenze nella console Google Cloud per cercare asset Cloud SQL.

  1. Vai alla pagina Ricerca del catalogo delle conoscenze.

    Vai a Cerca

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

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

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

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

Utilizzare le query per eseguire la ricerca

Puoi anche utilizzare il campo di ricerca in Knowledge Catalog per eseguire query di ricerca. Per visualizzare tutti gli asset Cloud SQL, inserisci system=Cloud_SQL.

Dopodiché puoi inserire parole chiave specifiche. Ad esempio, per visualizzare tutti i database Cloud SQL:

system=Cloud_SQL AND type=Database

Per visualizzare tutte le tabelle Cloud SQL, inserisci la seguente query:

system=Cloud_SQL AND type=Table

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

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

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

Sostituisci QUERY_STRING con una stringa di query basata sul motore Cloud SQL e sul tipo di asset che vuoi interrogare. Utilizza la tabella seguente per identificare la stringa di query appropriata.

Motore Cloud SQL Stringhe di query
Cloud SQL per MySQL
  • cloudsql-mysql-database
  • cloudsql-mysql-instance
  • cloudsql-mysql-table
  • cloudsql-mysql-view
Cloud SQL per PostgreSQL
  • cloudsql-postgresql-database
  • cloudsql-postgresql-instance
  • cloudsql-postgresql-table
  • cloudsql-postgresql-schema
  • cloudsql-postgresql-view
Cloud SQL per SQL Server
  • cloudsql-sqlserver-database
  • cloudsql-sqlserver-instance
  • cloudsql-sqlserver-table
  • cloudsql-sqlserver-schema
  • cloudsql-sqlserver-view

Una query di esempio potrebbe avere il seguente aspetto:

type="projects/dataplex-types/locations/global/entryTypes/cloudsql-postgresql-instance"

Filtra gli asset Cloud SQL per dialetto Cloud SQL

Per impostazione predefinita, Knowledge Catalog mostra tutti gli asset Cloud SQL. Per filtrare gli asset solo per Cloud SQL per MySQL, Cloud SQL per PostgreSQL o SQL Server, segui questi passaggi.

  1. Nel riquadro Aspetti, fai clic sul menu Aggiungi altri tipi di aspetti.

  2. Seleziona Accesso SQL.

  3. Fai clic su OK.

  4. Fai clic sul pulsante di modifica dell'aspetto playlist_add . Nella pagina Accesso SQL:

    • Nel campo Dialetto, seleziona PostgreSQL per filtrare gli asset Cloud SQL per PostgreSQL.
  5. Facoltativo. Seleziona il campo Versione e inserisci una versione specifica di Cloud SQL per PostgreSQL.

  6. Fai clic su Applica. Knowledge Catalog mostra solo gli asset Cloud SQL per PostgreSQL.

Knowledge Catalog include alcuni tipi di aspetti integrati che puoi utilizzare per eseguire ricerche.

  1. Nel riquadro Aspetti, fai clic sul menu Aggiungi altri tipi di aspetti.

  2. Facoltativo. Seleziona Accesso SQL per filtrare i risultati in base al dialetto Cloud SQL. Per ulteriori informazioni, consulta la procedura precedente, Filtrare gli asset Cloud SQL per dialetto Cloud SQL.

  3. Seleziona uno o più dei seguenti tipi di aspetto per limitare i risultati di ricerca a quel tipo.

    • Database Cloud SQL
    • Istanza Cloud SQL
    • Visualizzazione Cloud SQL
    • Schema Cloud SQL
    • Tabella Cloud SQL

  4. Fai clic su OK.

  5. Nella tabella dei risultati, fai clic sul nome della risorsa per visualizzare i metadati della risorsa.

  6. (Facoltativo) Migliora o visualizza gli asset. Puoi eseguire una delle seguenti operazioni:

    • In Panoramica, fai clic su Aggiungi per aggiungere una descrizione in formato RTF dell'asset.
    • In Aspetti, fai clic su Aggiungi per allegare un aspetto all'asset.
    • Ad esempio, per visualizzare i database dei membri, 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 l'istanza non ha database.
    • In Dettagli voce, visualizza i dettagli completi dell'asset. Fai clic sul nome della voce per visualizzare in dettaglio ulteriori voci.

Workflow di esempio: visualizzare in dettaglio dall'istanza alle colonne

In questo flusso di lavoro di esempio, inizi cercando un'istanza Cloud SQL, poi visualizzi un database membro, poi una tabella in quel database e infine le colonne della tabella.

  1. Vai alla pagina Ricerca del catalogo delle conoscenze.

    Vai a Cerca

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

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

  4. Seleziona un nome istanza.

  5. Nella pagina Dettagli Cloud SQL, fai clic sulla scheda Elenco voci, quindi su Mostra tutte le voci secondarie nella ricerca. Knowledge Catalog mostra i database nell'istanza.

  6. Nella pagina Dettagli database Cloud SQL, fai clic sulla scheda Elenco voci e poi su Visualizza voci secondarie nella ricerca. Knowledge Catalog mostra le tabelle nel database.

  7. Seleziona un nome tabella, quindi nella pagina Dettagli tabella Cloud SQL 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.

Questo flusso di lavoro mostra il drill-down da un'istanza a una tabella. Puoi andare direttamente a un elenco di tabelle inserendo system=Cloud_SQL AND type=Table nel campo di ricerca.

Prezzi

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

Utilizzo delle risorse

Quando l'integrazione di Knowledge Catalog è abilitata, Knowledge Catalog estrae periodicamente i dati dalle tue istanze. Il processo di estrazione richiede una certa quantità di utilizzo della CPU. Le istanze integrate con Knowledge Catalog quasi in tempo reale e le altre istanze create dopo il 18 aprile 2026 in genere hanno un impatto minimo sull'utilizzo della CPU. Per la maggior parte delle istanze create prima del 18 aprile 2026, incluse tutte le istanze create prima del 19 marzo 2026, l'utilizzo della CPU può essere maggiore. Ciò è particolarmente evidente per le istanze con tipi di macchine più piccoli, ad esempio le macchine con core condivisi e schemi più grandi (10.000 o più tabelle), che possono utilizzare fino al 40% della CPU durante il processo di estrazione.

Limitazioni

Questa sezione elenca le limitazioni relative all'utilizzo di Cloud SQL e Knowledge Catalog.

  • Per le istanze create prima del 18 aprile 2026, l'integrazione di Knowledge Catalog con Cloud SQL è disattivata per qualsiasi istanza che limita l'accesso alle risorse a causa della registrazione delle risorse in Assured Workloads.

  • Dopo aver abilitato Knowledge Catalog su un'istanza, potrebbero essere necessarie dalle 2 alle 48 ore prima che le risorse Cloud SQL vengano visualizzate in Knowledge Catalog come asset, a seconda delle dimensioni, della versione e del tipo di motore Cloud SQL che stai utilizzando. Questa limitazione non si applica quando l'istanza viene aggiornata quasi in tempo reale, come descritto in Quasi in tempo reale.

  • Le istanze che configuri per l'alta affidabilità (HA) non verranno abilitate automaticamente con Knowledge Catalog al momento della creazione. Se abiliti l'alta affidabilità per un'istanza con Knowledge Catalog già abilitato, Knowledge Catalog rimane abilitato a meno che non lo disattivi.

Le seguenti limitazioni si applicano solo quando l'istanza viene aggiornata quasi in tempo reale, come descritto in Quasi in tempo reale:

  • 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 rispettive tabelle sarà coerente in Knowledge Catalog.
  • L'integrazione di Knowledge Catalog quasi in tempo reale non è supportata per le istanze in cui sono abilitati i Controlli di servizio VPC.
  • Un'istanza potrebbe eliminare i messaggi, il che può causare la coerenza finale dei dati in Knowledge Catalog. Se i messaggi vengono eliminati, gli aggiornamenti mancanti diventano visibili in Knowledge Catalog alla fine. I casi in cui un'istanza potrebbe eliminare i messaggi includono:
    • Istanze che registrano un tasso elevato di DDL in un breve periodo di tempo.
    • Istanze clonate da un'istanza esistente.
    • Istanze ripristinate dal backup.
    • Istanze che stanno esaurendo la memoria.
    • Istanze in riavvio o in riavvio dei database.
    • Istanze che riscontrano problemi di rete o un'interruzione del processo di sincronizzazione con Knowledge Catalog.

Passaggi successivi