Linee guida per denominare una risorsa Knowledge Catalog

Una Google Cloud risorsa è qualsiasi componente che crei o utilizzi in Google Cloud. Queste risorse costituiscono i blocchi predefiniti delle applicazioni e dei sistemi in esecuzione sulla piattaforma.

Le risorse in Knowledge Catalog includono quanto segue:

  • Gruppo di voci

  • Voce

  • Tipo di voce

  • Tipo di aspetto

  • Link alla voce

  • Job metadati

  • Feed di metadati

  • Glossario

  • Categoria del glossario

  • Termine del glossario

  • Prodotto di dati

  • Dominio dei dati

  • Processo di tracciabilità

  • Esecuzione della derivazione

  • Evento di tracciabilità

Per ulteriori informazioni sulla denominazione delle risorse generali Google Cloud , consulta Nomi delle risorse.

Formato di denominazione delle risorse

Di seguito sono riportati i formati per le diverse risorse:

  • Gruppo di voci: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/entryGroups/{ENTRY_GROUP_ID}

  • Voce: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/entryGroups/{ENTRY_GROUP_ID}/entries/{ENTRY_ID}

  • Tipo di voce: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/entryTypes/{ENTRY_TYPE_ID}

  • Tipo di aspetto: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/aspectTypes/{ASPECT_TYPE_ID}

  • Link alla voce: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/entryGroups/{ENTRY_GROUP_ID}/entryLinks/{ENTRY_LINK_ID}

  • Job metadati: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/metadataJobs/{METADATA_JOB_ID}

  • Feed di metadati: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/metadataFeeds/{METADATA_FEED_ID}

  • Glossario: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/glossaries/{GLOSSARY_ID}

  • Categoria del glossario: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/glossaries/{GLOSSARY_ID}/categories/{GLOSSARY_CATEGORY_ID}

  • Termine del glossario: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/glossaries/{GLOSSARY_ID}/terms/{GLOSSARY_TERM_ID}

  • Prodotto di dati: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/dataProducts/{DATA_PRODUCT_ID}

  • Dominio dei dati: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/dataDomains/{DATA_DOMAIN_ID}

  • Processo: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/processes/{PROCESS_ID}

  • Esecuzione: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/processes/{PROCESS_ID}/runs/{RUN_ID}

  • Evento di tracciabilità: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/processes/{PROCESS_ID}/runs/{RUN_ID}/lineageEvents/{LINEAGE_EVENT_ID}

Le sezioni seguenti forniscono una suddivisione di ogni componente.

ID progetto

Il valore deve essere l'ID progetto o il numero di progetto, disponibile da la Google Cloud console. Ad esempio, my-cool-project è un ID progetto, mentre 123456789123 è un numero di progetto.

Località

Il valore deve essere una delle località di Knowledge Catalog supportate. Per un elenco delle località disponibili, consulta Località di Knowledge Catalog.

ID

ID è l'ultimo segmento nel percorso della risorsa.

Per la maggior parte delle risorse (gruppi di voci, tipi di voci, tipi di aspetti, link alle voci, job metadati, feed di metadati, glossari, categorie di glossari, termini di glossari, prodotti di dati e domini di dati), le variabili come {ENTRY_GROUP_ID}, {ENTRY_TYPE_ID}, {ASPECT_TYPE_ID}, {ENTRY_LINK_ID}, {METADATA_JOB_ID}, {METADATA_FEED_ID}, {GLOSSARY_ID}, {GLOSSARY_CATEGORY_ID}, {GLOSSARY_TERM_ID}, {DATA_PRODUCT_ID}, e {DATA_DOMAIN_ID} devono rispettare le seguenti linee guida:

  • Deve iniziare con una lettera minuscola.

  • Deve contenere da 1 a 63 caratteri.

  • Deve contenere solo lettere minuscole, numeri, trattini e trattini bassi.

  • Deve terminare con un numero o una lettera minuscola.

Le linee guida per la denominazione di un {ENTRY_ID} sono diverse:

  • Deve contenere fino a 4000 caratteri.

  • Utilizza un formato di ID voce basato sul Google Cloud nome completo della risorsa. Il formato è il nome completo della risorsa senza le barre doppie del prefisso nella parte del nome del servizio API. In questo modo è possibile recuperare le voci utilizzando il nome della risorsa associata.

    Ad esempio:

    • Se il nome completo della risorsa di un'istanza di Looker è //looker.googleapis.com/projects/my-project/locations/us-central1/instances/my-instance, allora il suggerito {ENTRY_ID} è looker.googleapis.com/projects/my-project/locations/us-central1/instances/my-instance.

Per le risorse di tracciabilità dei dati, come processi, esecuzioni ed eventi di tracciabilità, le variabili {PROCESS_ID}, {RUN_ID} e {LINEAGE_EVENT_ID} devono rispettare le seguenti linee guida:

  • Deve contenere fino a 200 caratteri.

  • Deve contenere solo lettere (distingue tra maiuscole e minuscole), numeri, trattini, trattini bassi, due punti e punti.

Nomi delle voci di BigQuery

Quando interagisci con le risorse BigQuery tramite le API Knowledge Catalog, devi utilizzare una formattazione specifica per l'ID del gruppo di voci e l'ID della voce.

  • ID del gruppo di voci: @bigquery
  • ID voce: bigquery.googleapis.com/projects/{PROJECT_ID}/datasets/{DATASET_ID}/tables/{TABLE_ID}

Esempio

Se la tabella BigQuery è projects/test-project/datasets/test_dataset/tables/test_table, il nome della voce di Knowledge Catalog completo è il seguente:

projects/{PROJECT_ID}/locations/{LOCATION_NAME}/entryGroups/@bigquery/entries/bigquery.googleapis.com/projects/test-project/datasets/test_dataset/tables/test_table