Utilizzare i 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.

In qualità di utente del dominio di dati, puoi utilizzare i domini di dati per restringere i risultati di ricerca a contesti aziendali specifici, cercare set di dati, tabelle e prodotti di dati BigQuery e scoprire i metadati all'interno di limiti di dominio specifici.

Prima di iniziare

Prima di eseguire una ricerca per dominio, assicurati di avere i ruoli richiesti e le API abilitate.

Abilita API

Abilitare l'API Dataplex.

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 utilizzo servizi (roles/serviceusage.serviceUsageAdmin). Scopri come concedere i ruoli.

Abilitare l'API

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per cercare e scoprire i metadati utilizzando i domini di dati, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto o nel dominio di dati:

• Visualizza i metadati delle voci di dominio per la scoperta: Dataplex Data Domain Entry Reader (roles/dataplex.dataDomainEntryReader)
• Visualizza le configurazioni e i binding dei domini: 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.

Sfoglia la gerarchia dei domini

Per ulteriori informazioni su come sfogliare la gerarchia dei domini, consulta Visualizzare domini e sottodomini di dati in una località.

Trova risorse all'interno di un dominio di dati

Per cercare risorse con un dominio:

Console

1. Nella Google Cloud console, vai alla pagina Knowledge Catalog > Search.

   Vai a Ricerca

2. Fai clic su Prova la ricerca naturale per attivare la funzionalità dei risultati di ricerca.

3. Fai clic su Filtri.

4. Nel campo Ambito, seleziona Dominio dall'elenco.

5. Nel campo Seleziona dominio, seleziona il dominio a cui vuoi restringere i risultati. Se necessario, aggiungi altri filtri.

In alternativa, puoi utilizzare l'opzione di menu Cerca all'interno del dominio per trovare le risorse nel dominio:

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

   Vai a Domini di dati

2. Seleziona Cerca all'interno del dominio dal menu more_vert. Questa azione apre automaticamente una finestra di ricerca con il filtro dominio applicato.

3. Utilizza il campo di ricerca per trovare le risorse nel dominio.

REST

Per cercare voci con ambito in un dominio di dati, utilizza il metodo projects.locations.searchEntries e fornisci il percorso del dominio nel parametro contexts.

Nota: la località nel percorso di searchEntries può essere global (per il fanout completo) o una regione specifica a seconda della configurazione del backend di ricerca.

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

• PROJECT_ID: l'ID del tuo Google Cloud progetto.
• LOCATION_ID: la regione per la query di ricerca (o global).
• QUERY: la stringa di query.
• DOMAIN_ID: l'identificatore univoco del dominio di dati che definisce il contesto dell'ambito di ricerca.

Metodo HTTP e URL:

POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID:searchEntries

Corpo JSON della richiesta:

{
  "query": "QUERY",
  "contexts": [ "projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID" ],
  "semantic_search": true,
  "page_size": 100
}

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 POST \
     -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:searchEntries"

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, e quindi 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://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID:searchEntries" | Select-Object -Expand Content

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

Limitazioni

Quando cerchi risorse al di fuori del contesto del dominio, ad esempio quando utilizzi una ricerca globale, le autorizzazioni di rilevabilità del dominio non vengono applicate. Vedi solo le risorse a cui hai accesso nel sistema sottostante, ad esempio BigQuery.

Supponiamo che un set di dati BigQuery sia incluso in un dominio di dati. Hai il ruolo Dataplex Data Domain Entry Reader per il dominio, ma non hai l'autorizzazione diretta per visualizzare il set di dati in BigQuery:

• Ricerca all'interno del dominio: vedi il set di dati nei risultati di ricerca perché vengono applicate le autorizzazioni del dominio.
• Ricerca al di fuori del dominio: non vedi il set di dati nei risultati di ricerca. In una ricerca generale, le autorizzazioni del dominio non vengono applicate e non hai accesso diretto in BigQuery.

Passaggi successivi

• Scopri di più sui domini di dati.
• Scopri come creare domini di dati.
• Scopri come gestire le risorse del dominio di dati.