Gestisci domini di dati

Anteprima

Questo prodotto o funzionalità sono soggetti ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Knowledge Catalog (in precedenza Dataplex Universal Catalog) consente di visualizzare, aggiornare ed eliminare domini e sottodomini di dati utilizzando la console Google Cloud e l'API REST. Puoi ispezionare le risorse incluse, modificare i nomi visualizzati e le etichette o rimuovere i domini vuoti per mantenere la gerarchia allineata alla struttura aziendale.

Prima di iniziare

Prima di gestire i domini di dati, assicurati di avere i ruoli e le API richiesti abilitati.

Abilita API

Abilita l'API Dataplex, se non è già abilitata.

Ruoli richiesti per abilitare le API

Per abilitare le API, devi disporre dell'autorizzazione serviceusage.services.enable. Se hai creato il progetto, probabilmente hai già questa autorizzazione tramite il ruolo Proprietario (roles/owner). In caso contrario, puoi ottenere questa autorizzazione tramite il ruolo Amministratore Service Usage (roles/serviceusage.serviceUsageAdmin). Scopri come concedere i ruoli.

Abilitare l'API

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per gestire i domini di dati, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto:

• Aggiorna i domini di dati e le associazioni delle risorse: Dataplex Data Domain Configuration Editor (roles/dataplex.dataDomainEditor)
• Visualizza la configurazione del dominio di dati e delle associazioni: Dataplex Data Domain Configuration Viewer (roles/dataplex.dataDomainViewer)

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Visualizza domini e sottodomini di dati

Visualizza i domini e i sottodomini di dati in un progetto specifico.

Console

Visualizza tutti i domini di dati

1. Nella console Google Cloud , vai alla pagina Domini di dati.

   Vai a Domini di dati

2. La tabella elenca i domini creati. Fai clic sulla freccia Espandi accanto al nome del dominio di dati per visualizzare i sottodomini nidificati.

Visualizza i dettagli del dominio e del sottodominio dei dati

1. Nella console Google Cloud , vai alla pagina Domini di dati.

   Vai a Domini di dati

2. Fai clic sul nome del dominio o del sottodominio che vuoi visualizzare.

3. La pagina Dettagli dominio mostra le seguenti schede:

   • Panoramica: fornisce una panoramica del dominio e l'elenco degli aspetti obbligatori e facoltativi.
   • Risorse: elenca le risorse incluse in questo dominio. L'elenco mostra solo le cartelle, le risorse e i progetti inclusi direttamente nel dominio.

REST

Visualizza i domini e i sottodomini di dati

Per visualizzare i domini di dati, utilizza il metodo projects.locations.dataDomains.list:

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

• PROJECT_ID: l'ID del tuo progetto Google Cloud .
• LOCATION_ID: la regione del progetto. Ad esempio, us-central1.

Metodo HTTP e URL:

GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

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

PowerShell (Windows)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains" | Select-Object -Expand Content

Dovresti ricevere un codice di stato riuscito (2xx) e una risposta vuota.

Visualizza i sottodomini dei dati

Per visualizzare i sottodomini di dati, utilizza il metodo projects.locations.dataDomains.listSubdomains:

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

• PROJECT_ID: l'ID del tuo progetto Google Cloud .
• LOCATION_ID: la regione in cui si trova il dominio di dati principale. Ad esempio, us-central1.
• DOMAIN_ID: l'identificatore univoco del dominio di dati principale.

Metodo HTTP e URL:

GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID/subdomains

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

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

PowerShell (Windows)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID/subdomains" | Select-Object -Expand Content

Dovresti ricevere un codice di stato riuscito (2xx) e una risposta vuota.

Utilizza il parametro filter per elencare i sottodomini appartenenti a un dominio principale specifico:

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

• PROJECT_ID: l'ID del tuo progetto Google Cloud .
• LOCATION_ID: la regione in cui si trova il dominio di dati principale. Ad esempio, us-central1.
• PARENT_DOMAIN_ID: l'identificatore univoco del dominio di dati principale.

Metodo HTTP e URL:

GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains?filter=parent_data_domain="projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/PARENT_DOMAIN_ID"

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains?filter=parent_data_domain="projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/PARENT_DOMAIN_ID""

PowerShell (Windows)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains?filter=parent_data_domain="projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/PARENT_DOMAIN_ID"" | Select-Object -Expand Content

Dovresti ricevere un codice di stato riuscito (2xx) e una risposta vuota.

Visualizza i dettagli del dominio di dati

Per ottenere i dettagli del dominio o del sottodominio, utilizza il metodo projects.locations.dataDomains.get:

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

• PROJECT_ID: l'ID del tuo progetto Google Cloud .
• LOCATION_ID: la regione in cui si trova il dominio di dati. Ad esempio, us-central1.
• DOMAIN_ID: l'identificatore univoco del dominio o del sottodominio di dati.

Metodo HTTP e URL:

GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

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

PowerShell (Windows)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID" | Select-Object -Expand Content

Dovresti ricevere un codice di stato riuscito (2xx) e una risposta vuota.

Aggiorna un dominio o un sottodominio di dati

Puoi aggiornare il nome visualizzato, la descrizione e le etichette di un dominio. Non puoi modificare l'ID o la località del dominio dopo averlo creato.

Console

1. Nella console Google Cloud , vai alla pagina Domini di dati.

   Vai a Domini di dati

2. Fai clic sul nome del dominio o del sottodominio per andare alla pagina dei dettagli.

3. Nella barra superiore, fai clic su Modifica.

4. Aggiorna il Nome visualizzato o la Descrizione.

5. Fai clic su Salva.

REST

Per aggiornare un dominio di dati, utilizza il metodo projects.locations.dataDomains.patch:

Nota: devi specificare i campi da aggiornare utilizzando il parametro di query updateMask per evitare di sovrascrivere altre proprietà.

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

• PROJECT_ID: l'ID del tuo progetto Google Cloud .
• LOCATION_ID: la regione in cui si trova il dominio di dati. Ad esempio, us-central1.
• DOMAIN_ID: l'identificatore univoco del dominio o del sottodominio di dati.

Metodo HTTP e URL:

PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID?updateMask=description,labels

Corpo JSON della richiesta:

{
  "description": "Updated description for the domain",
  "labels": {
    "status": "active"
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, quindi 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://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID?updateMask=description,labels"

PowerShell (Windows)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, quindi 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://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID?updateMask=description,labels" | Select-Object -Expand Content

Dovresti ricevere un codice di stato riuscito (2xx) e una risposta vuota.

Elimina un dominio o un sottodominio di dati

Puoi eliminare solo un dominio di dati vuoto. Prima di tentare di eliminare il dominio, devi eliminare tutti i sottodomini e rimuovere tutte le associazioni di risorse associate al dominio. Se il dominio non è vuoto, la richiesta di eliminazione non va a buon fine e viene visualizzato un errore.

Console

1. Nella console Google Cloud , vai alla pagina Domini di dati.

   Vai a Domini di dati

2. Fai clic sul nome del dominio o del sottodominio per andare alla pagina dei dettagli.

3. Nella barra in alto, fai clic su Elimina.

4. Conferma l'eliminazione digitando il nome del dominio o del sottodominio dei dati.

5. Fai clic su Elimina.

REST

Per eliminare un dominio di dati, utilizza il metodo projects.locations.dataDomains.delete:

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

• PROJECT_ID: l'ID del tuo progetto Google Cloud .
• LOCATION_ID: la regione in cui si trova il dominio di dati. Ad esempio, us-central1.
• DOMAIN_ID: l'identificatore univoco del dominio o del sottodominio di dati.

Metodo HTTP e URL:

DELETE https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID"

PowerShell (Windows)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID" | Select-Object -Expand Content

Dovresti ricevere un codice di stato riuscito (2xx) e una risposta vuota.

Passaggi successivi

• Scopri di più sui domini di dati.
• Scopri di più sull'associazione e l'inclusione delle risorse.
• Scopri come creare domini di dati.
• Scopri come utilizzare i domini di dati.