Gestisci le risorse AlloyDB utilizzando Dataplex Universal Catalog

Puoi cercare e gestire le risorse AlloyDB per PostgreSQL utilizzando Dataplex Universal Catalog, una piattaforma per archiviare, gestire e accedere ai tuoi metadati. Puoi utilizzare Dataplex Universal Catalog per scoprire e comprendere i metadati di AlloyDB. Utilizza Dataplex Universal Catalog per aiutarti a quanto segue:

  • Analisi, incluse le dipendenze e l'idoneità per un caso d'uso
  • Gestione dei cambiamenti
  • Evoluzione dello schema

Dataplex Universal Catalog recupera automaticamente i seguenti metadati da AlloyDB:

Tipo di risorsa Metadati recuperati
Cluster, database e istanze
  • Nome
  • Località (regione)
Schema, colonne, tabelle, viste
  • Nome
  • Località (regione)
  • Descrizione
  • Schema

Tipi di rilevamento dei metadati

Il rilevamento dei metadati, nel contesto di Dataplex Universal Catalog, è il processo automatizzato in cui Dataplex Universal Catalog analizza le origini dati connesse, come AlloyDB, per identificare gli asset di dati (come tabelle, viste e database) ed estrarre i relativi metadati tecnici (come schemi, descrizioni e posizioni) nel catalogo.

Questo processo viene eseguito periodicamente per mantenere il catalogo sincronizzato con i sistemi di origine. Per AlloyDB, i metadati di cluster e istanze vengono rilevati per impostazione predefinita, mentre i metadati di database, schema, tabella e vista vengono rilevati solo quando attivi l'integrazione sul cluster.

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

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

Per saperne di più, consulta Sintassi di ricerca per Dataplex Universal 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 Dataplex Universal Catalog abilitata. All'interno dell'istanza principale di questo cluster, hai un database denominato profiles che contiene una tabella customers (id, email, signup_date) e una vista active_users (id, email).

AlloyDB viene sincronizzato periodicamente con Dataplex Universal Catalog, le seguenti risorse sono disponibili:

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

Al termine del rilevamento, puoi cercare questi asset, ovvero customerstabelle e active_users, nella pagina Dataplex Universal Catalog della console Google Cloud o utilizzando l'API, visualizzare i relativi schemi e arricchirli con metadati aziendali o operativi aggiuntivi.

Arricchire i metadati utilizzando 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 Dataplex Universal Catalog per creare i tipi di aspetto di cui hai bisogno.

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

  • 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'associazione 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. Devi abilitare l'integrazione di Dataplex Universal Catalog per il tuo cluster AlloyDB solo se vuoi importare e scoprire risorse di database, schema, tabella e vista.

  1. Per scoprire le risorse di database, schema, tabella e visualizzazione AlloyDB, devi abilitare l'integrazione di Dataplex Universal Catalog per il tuo cluster AlloyDB utilizzando l'API AlloyDB quando crei un nuovo cluster o quando aggiorni un cluster esistente. Per saperne di più, consulta Creare un cluster e la relativa istanza principale.

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

  3. Per aggiungere più contesto agli asset AlloyDB, puoi allegare aspetti agli asset. Gli aspetti sono voci di metadati personalizzate che aiutano la governance e l'analisi dei dati. Ad esempio, puoi utilizzare 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.

  4. Ora puoi navigare tra le risorse AlloyDB seguendo questa gerarchia: Cluster > Database > Schema > Tabella o Visualizzazione > Colonna. che fornisce una visione dettagliata del tuo panorama dei dati. Per saperne di più, consulta Cercare risorse in Dataplex Universal Catalog.

Prima di iniziare

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

    Roles required to select or create a project

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

    Go to project selector

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

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

    Roles required to select or create a project

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

    Go to project selector

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

  6. Abilita l'API Dataplex per il progetto.

    Abilitare l'API Dataplex

  7. Controlla le autorizzazioni.

    Per cercare e allegare voci alle risorse AlloyDB, devi disporre di determinati ruoli e autorizzazioni Identity and Access Management (IAM). Per maggiori dettagli, vedi Ruoli e autorizzazioni IAM richiesti per Dataplex Universal Catalog.

  8. 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 di AlloyDB in Dataplex Universal Catalog, i principal devono disporre delle 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 del Catalogo universale Dataplex 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, puoi assegnare 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

    Per cercare le 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 Cercare asset di dati con Dataplex Universal Catalog.

    Abilita l'integrazione di Dataplex Universal Catalog nel cluster AlloyDB

    Per impostazione predefinita, le risorse del cluster e dell'istanza vengono importate e sono rilevabili. Devi abilitare l'integrazione di Dataplex Universal Catalog per il tuo cluster AlloyDB solo se vuoi importare e scoprire risorse di database, schema, tabella e vista.

    Per importare e rendere rilevabili le risorse di database, schema, tabella e vista, crea o aggiorna il cluster utilizzando l'API AlloyDB. L'attivazione di questa integrazione consente la sincronizzazione delle risorse di database, schema, tabella e visualizzazione dei metadati del piano dati.

    Per l'integrazione con Dataplex Universal Catalog, utilizza il flag dataplexConfig a livello di cluster. Per visualizzare i dati per i cluster secondari, devi abilitare questo flag separatamente. Per attivare l'esportazione dei metadati di AlloyDB, ad esempio database, schemi e tabelle, nei bucket Cloud Storage, imposta enabled su true. Questi dati sono quindi disponibili per l'utilizzo da parte di Dataplex Universal Catalog. Questa funzionalità è applicabile solo alle istanze principali.

    Abilitare l'integrazione di Dataplex Universal Catalog durante la creazione di un cluster

    Per creare un cluster AlloyDB con l'integrazione di Dataplex Universal Catalog abilitata, utilizza il metodo POST e il seguente URL. 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.

    Non includere informazioni sensibili o che consentono l'identificazione personale nell'ID cluster perché è visibile esternamente. Non devi includere l'ID progetto nel nome del cluster. Questa operazione viene eseguita automaticamente, ove opportuno, ad esempio nei file di log.

    Per inviare la richiesta, salva il corpo della richiesta in un file denominato cluster_request.json:

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

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

    Abilitare l'integrazione di Dataplex Universal Catalog per il cluster AlloyDB

    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/clusters/CLUSTER_ID
    

    Effettua le seguenti sostituzioni:

    • PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene il 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/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 PATCH `
        -Headers $headers `
        -ContentType: "application/json; charset=utf-8" `
        -InFile request.json `
        -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID"| Select-Object -Expand Content
    

    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 Dataplex Universal Catalog nel cluster AlloyDB

    Per verificare che l'integrazione di Dataplex Universal 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/clusters/CLUSTER_ID
    

    Effettua le seguenti sostituzioni:

    • PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene il 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/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/clusters/CLUSTER_ID"| Select-Object -Expand Content
    

    Ricevi una risposta JSON per l'intero proto del cluster. Cerca il messaggio dataplexConfig all'interno del proto:

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

    Disattiva l'integrazione di Dataplex Universal Catalog nel cluster AlloyDB

    Utilizza il seguente esempio per disattivare l'integrazione. Quando disattivi questa funzionalità, sono disponibili solo i metadati del cluster e dell'istanza.

    Utilizza il seguente metodo HTTP e URL:

    PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_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.
    • 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/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 PATCH `
        -Headers $headers `
        -ContentType: "application/json; charset=utf-8" `
        -InFile request.json `
        -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID"| Select-Object -Expand Content
    

    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

    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 Dataplex Universal Catalog per creare i tipi di aspetto di cui hai bisogno.

    Dopo aver creato tipi di aspetti personalizzati, puoi allegare gli aspetti agli asset AlloyDB. Il collegamento di aspetti agli asset AlloyDB ti consente di:

    • 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 di Dataplex Universal Catalog nella console Google Cloud per cercare gli asset AlloyDB.

    1. Vai alla pagina Cerca di Dataplex Universal Catalog.

      Vai a Cerca

    2. In Scegli piattaforma di ricerca, seleziona Dataplex Universal Catalog.

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

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

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

    Puoi utilizzare il campo di ricerca in Dataplex Universal Catalog per eseguire query di ricerca per parole chiave. Ad esempio, puoi inserire system=AlloyDB AND type=Database per visualizzare tutti i database AlloyDB.

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

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

    Dopodiché puoi inserire 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 Dataplex Universal 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 per cui vuoi eseguire query:

      • 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

    Dataplex Universal Catalog include alcuni tipi di aspetto integrati che puoi utilizzare per eseguire ricerche.

    Per eseguire la ricerca per tipo di aspetto:

    1. Nel riquadro Aspetti, fai clic sul menu Aggiungi altri tipi di aspetti.
    2. Facoltativo. Seleziona AlloyDB Access per filtrare i risultati in base al dialetto AlloyDB.
    3. 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
    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 eseguire una delle seguenti operazioni:
      • Per aggiungere una descrizione in formato RTF dell'asset, in Panoramica, fai clic su Aggiungi .
      • Per allegare un aspetto all'asset, in Aspetti, fai clic su Aggiungi .
      • Per visualizzare i database dei 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, il cluster non ha database.
      • In Dettagli voce, visualizza i dettagli completi dell'asset. Fai clic sul nome della voce per visualizzare ulteriori voci.

    Ricerca in linguaggio naturale in AlloyDB

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

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

    Ricerca della sintassi in AlloyDB

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

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

    Flusso di lavoro di esempio: visualizzare in dettaglio dal cluster alle colonne

    Per visualizzare in dettaglio dal cluster alle colonne:

    1. Vai alla pagina Cerca di Dataplex Universal Catalog.

      Vai a Cerca

    2. Per l'opzione Scegli piattaforma di ricerca, seleziona Dataplex Universal Catalog.

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

    4. Seleziona un nome del cluster.

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

    6. Nella pagina Dettagli database AlloyDB, fai clic sulla scheda Elenco voci, quindi su Visualizza voci secondarie nella ricerca. Dataplex Universal Catalog mostra 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 è previsto alcun costo per l'archiviazione dei metadati tecnici di AlloyDB in Dataplex Universal Catalog. Per le chiamate API e l'arricchimento dei metadati aziendali aggiuntivi si applicano i prezzi standard del catalogo universale Dataplex. Per saperne di più, consulta la pagina dei prezzi di Dataplex Universal Catalog.

    Utilizzo delle risorse

    Dataplex Universal Catalog estrae periodicamente i dati dai cluster. Il processo di estrazione richiede una certa quantità di utilizzo della CPU. I cluster con tipi di macchine più piccoli, ad esempio macchine che condividono schemi più grandi (10.000 o più tabelle), possono utilizzare una piccola quantità di CPU durante il processo di estrazione.

    Limitazioni

    • È consentito un massimo di un milione di tabelle per database.
    • Potrebbero essere necessarie fino a 48 ore prima che gli aggiornamenti al database vengano visualizzati in Dataplex Universal Catalog.
    • In genere, il processo di estrazione richiede alcuni minuti, ma il tempo di completamento dipende dalle dimensioni della CPU e dal numero di tabelle.
    • Quando un'istanza non esiste o non è in esecuzione, possono essere necessari 7 giorni per l'eliminazione dei metadati.

    Passaggi successivi