Lineamientos para asignar un nombre a un recurso de Knowledge Catalog

Un Google Cloud recurso es cualquier componente que creas o usas en Google Cloud. Estos recursos forman los componentes básicos de tus aplicaciones y sistemas que se ejecutan en la plataforma.

Los recursos de Knowledge Catalog incluyen los siguientes:

  • Grupo de entradas

  • Entrada

  • Tipo de entrada

  • Tipo de aspecto

  • Vínculo de entrada

  • Trabajo de metadatos

  • Feed de metadatos

  • Glosario

  • Categoría del glosario

  • Término del glosario

  • Producto de datos

  • Dominio de datos

  • Proceso de linaje

  • Ejecución de linaje

  • Evento de linaje

Para obtener más información sobre los nombres de recursos generales Google Cloud , consulta Nombres de recursos.

Formato de nombres de recursos

Estos son los formatos para los diferentes recursos:

  • Grupo de entradas: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/entryGroups/{ENTRY_GROUP_ID}

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

  • Tipo de entrada: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/entryTypes/{ENTRY_TYPE_ID}

  • Tipo de aspecto: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/aspectTypes/{ASPECT_TYPE_ID}

  • Vínculo de entrada: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/entryGroups/{ENTRY_GROUP_ID}/entryLinks/{ENTRY_LINK_ID}

  • Trabajo de metadatos: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/metadataJobs/{METADATA_JOB_ID}

  • Feed de metadatos: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/metadataFeeds/{METADATA_FEED_ID}

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

  • Categoría del glosario: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/glossaries/{GLOSSARY_ID}/categories/{GLOSSARY_CATEGORY_ID}

  • Término del glosario: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/glossaries/{GLOSSARY_ID}/terms/{GLOSSARY_TERM_ID}

  • Producto de datos: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/dataProducts/{DATA_PRODUCT_ID}

  • Dominio de datos: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/dataDomains/{DATA_DOMAIN_ID}

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

  • Ejecución: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/processes/{PROCESS_ID}/runs/{RUN_ID}

  • Evento de linaje: projects/{PROJECT_ID}/locations/{LOCATION_NAME}/processes/{PROCESS_ID}/runs/{RUN_ID}/lineageEvents/{LINEAGE_EVENT_ID}

En las siguientes secciones, se proporciona un desglose de cada componente.

ID del proyecto

El valor debe ser el ID del proyecto o el número del proyecto, disponible en la Google Cloud consola. Por ejemplo, my-cool-project es un ID del proyecto, mientras que 123456789123 es un número del proyecto.

Ubicación

El valor debe ser una de las ubicaciones admitidas de Knowledge Catalog. Para obtener una lista de las ubicaciones disponibles, consulta Ubicaciones de Knowledge Catalog.

ID

ID es el segmento final en la ruta de acceso del recurso.

Para la mayoría de los recursos (grupos de entradas, tipos de entradas, tipos de aspectos, vínculos de entradas, trabajos de metadatos, feeds de metadatos, glosarios, categorías de glosarios, términos de glosarios, productos de datos y dominios de datos), las variables como {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} y {DATA_DOMAIN_ID} deben cumplir con los siguientes lineamientos:

  • Comienza con una letra en minúscula.

  • Contiene entre 1 y 63 caracteres.

  • Contiene solo letras minúsculas, números, guiones y guiones bajos.

  • Termina con un número o una letra minúscula.

Los lineamientos de nombres para un {ENTRY_ID} son diferentes:

  • Contiene hasta 4,000 caracteres.

  • Usa un formato de ID de entrada basado en el Google Cloud nombre de recurso completo. El formato es el nombre de recurso completo del recurso sin las barras diagonales dobles de prefijo en la parte del nombre del servicio de la API. Esto permite recuperar entradas con su nombre de recurso asociado.

    Por ejemplo:

    • Si el nombre de recurso completo de una instancia de Looker es //looker.googleapis.com/projects/my-project/locations/us-central1/instances/my-instance, el {ENTRY_ID} sugerido es looker.googleapis.com/projects/my-project/locations/us-central1/instances/my-instance.

Para los recursos de linaje de datos, como procesos, ejecuciones y eventos de linaje, las variables {PROCESS_ID}, {RUN_ID} y {LINEAGE_EVENT_ID} deben cumplir con los siguientes lineamientos:

  • Contiene hasta 200 caracteres.

  • Contiene solo letras (distingue mayúsculas de minúsculas), números, guiones, guiones bajos, dos puntos y puntos.

Nombres de entradas de BigQuery

Cuando interactúas con los recursos de BigQuery a través de las APIs de Knowledge Catalog, debes usar un formato específico para el ID del grupo de entradas y el ID de entrada.

  • ID del grupo de entradas: @bigquery
  • ID de entrada: bigquery.googleapis.com/projects/{PROJECT_ID}/datasets/{DATASET_ID}/tables/{TABLE_ID}

Ejemplo

Si tu tabla de BigQuery es projects/test-project/datasets/test_dataset/tables/test_table, el nombre de entrada completamente calificado de Knowledge Catalog es el siguiente:

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