A partire dal 10 aprile 2026, Dataplex Universal Catalog si chiama Knowledge Catalog. I nomi di API, libreria client, CLI e IAM rimangono invariati. Per ulteriori informazioni, consulta Presentazione di Google Cloud Knowledge Catalog.

Nomi completi

I nomi completi sono identificatori di risorse univoci a livello globale e sensibili alle maiuscole e alle minuscole che puoi utilizzare con Knowledge Catalog (in precedenza Dataplex Universal Catalog) per fare riferimento a risorse Google Cloud e nonGoogle Cloud .

Ad esempio, i nomi completi vengono utilizzati per i sistemi che supportano l'importazione automatica dei metadati da Google Cloud. Se cataloghi le risorse non-Google Cloud in Knowledge Catalog, puoi fornire nomi completi quando crei le voci personalizzate che rappresentano queste risorse di terze parti.

I nomi completi sono composti da un prefisso seguito da segmenti delimitati da punti. La lunghezza massima è di 4000 caratteri. Racchiudi i segmenti che contengono caratteri riservati, come i due punti, i punti e gli spazi, tra apici inversi. Utilizza i doppi apici inversi per specificare un apice inverso all'interno di un segmento.

Formati predefiniti per le risorse Google Cloud

Le tabelle seguenti elencano i formati predefiniti per i nomi completi supportati per le risorse Google Cloud .

BigQuery

Risorsa	Formato
Set di dati	`bigquery:{projectId}.{datasetId}`
Tabella	`bigquery:{projectId}.{datasetId}.{tableId}`
Visualizza	`bigquery:{projectId}.{datasetId}.{viewId}`
Modello	`bigquery:{projectId}.{datasetId}.{modelId}`
Tabella con sharding	`bigquery:sharded:{projectId}.{datasetId}.{tablePrefix}`
Routine	`bigquery:routine:{projectId}.{datasetId}.{routineId}`
Connessione	`bigquery:connection:{projectId}.{location}.{connectionId}`

BigQuery sharing (in precedenza Analytics Hub)

Risorsa	Formato
Exchange	`analytics_hub:{projectId}.{location}.{exchangeId}`
Scheda	`analytics_hub:{projectId}.{location}.{exchangeId}.{listingId}`

Bigtable

Risorsa	Formato
Istanza	`bigtable:{projectId}.{instanceId}`
Tabella	`bigtable:{projectId}.{instanceId}.{tableId}`

Cloud SQL per MySQL

Risorsa	Formato
Istanza	`cloudsql_mysql:{projectId}.{location}.{instanceId}`
Schema	`cloudsql_mysql:{projectId}.{location}.{instanceId}.{schemaId}`
Tabella	`cloudsql_mysql:{projectId}.{location}.{instanceId}.{schemaId}.{tableId}`

Cloud SQL per PostgreSQL

Risorsa	Formato
Istanza	`cloudsql_postgresql:{projectId}.{location}.{instanceId}`
Database	`cloudsql_postgresql:{projectId}.{location}.{instanceId}.{databaseId}`
Schema	`cloudsql_postgresql:{projectId}.{location}.{instanceId}.{databaseId}.{schemaId}`
Tabella	`cloudsql_postgresql:{projectId}.{location}.{instanceId}.{databaseId}.{schemaId}.{tableId}`

Cloud Storage

Risorsa	Formato
Bucket	`gcs:{bucketName}`
Percorso	`gcs:{bucketName}.{virtualPath}`

Knowledge Catalog

Risorsa	Formato
Lake	`dataplex:{projectId}.{location}.{lakeId}`
Zona	`dataplex:{projectId}.{location}.{lakeId}.{zoneId}`
Tabella	`dataplex:{projectId}.{location}.{lakeId}.{zoneId}.{tableId}`
Set di file	`dataplex:{projectId}.{location}.{lakeId}.{zoneId}.{filesetId}`

Dataproc Metastore

Risorsa	Formato
Servizio	`dataproc_metastore:{projectId}.{location}.{instanceId}`
Database	`dataproc_metastore:{projectId}.{location}.{instanceId}.{databaseId}`
Tabella	`dataproc_metastore:{projectId}.{location}.{instanceId}.{databaseId}.{tableId}`

Looker

Risorsa	Formato
Istanza	`looker:{instanceId}`
Dashboard	`looker:dashboard:{instanceId}.{folderId}.{dashboardId}`
Esplora	`looker:explore:{instanceId}.{folderId}.{exploreId}`
Look	`looker:look:{instanceId}.{folderId}.{lookId}`

Pub/Sub

Risorsa	Formato
Argomento	`pubsub:topic:{projectId}.{topicId}`
Abbonamento	`pubsub:subscription:{projectId}.{subscriptionId}`

Spanner

Risorsa	Formato
Istanza	`spanner:{projectId}.{instanceConfigId}.{instanceId}`
Database	`spanner:{projectId}.{instanceConfigId}.{instanceId}.{databaseId}`
Tabella	`spanner:{projectId}.{instanceConfigId}.{instanceId}.{databaseId}.{tableId}`
Visualizza	`spanner:{projectId}.{instanceConfigId}.{instanceId}.{databaseId}.{viewId}`

Vertex AI

Risorsa	Formato
Modello	`vertex_ai:model:{projectId}.{locationId}.{modelId}.{version}`
Set di dati	`vertex_ai:dataset:{projectId}.{locationId}.{datasetId}`
FeatureGroup	`vertex_ai:featuregroup:{projectId}.{locationId}.{featureGroupId}`
FeatureOnlineStore	`vertex_ai:featureonlinestore:{projectId}.{locationId}.{featureOnlineStoreId}`
FeatureView	`vertex_ai:featureonlinestore:{projectId}.{locationId}.{featureOnlineStoreId}.{FeatureViewId}`

Formati predefiniti per le risorse nonGoogle Cloud

Le tabelle seguenti elencano i formati predefiniti per i nomi completi supportati per le risorse di terze parti.

Apache Cassandra

Risorsa	Formato
Cluster	`cassandra:{dns}`
Keyspace	`cassandra:{dns}.{keyspaceId}`
Tabella	`cassandra:{dns}.{keyspaceId}.{tableId}`

Apache Hive

Risorsa	Formato
Istanza	`hive_metastore:{dns}`
Database	`hive_metastore:{dns}.{database}`
Tabella	`hive_metastore:{dns}.{database}.{table}`

Apache Kafka

Risorsa	Formato
Cluster	`kafka:{dns}`
Argomento	`kafka:{dns}.{topicId}`

AWS Athena

Risorsa	Formato
Catalogo	`athena:{catalogId}.{region}`
Database	`athena:{catalogId}.{region}.{databaseId}`
Tabella	`athena:{catalogId}.{region}.{databaseId}.{tableId}`

AWS Redshift

Risorsa	Formato
Istanza	`redshift:{clusterId}.{region}.{port}`
Database	`redshift:{clusterId}.{region}.{port}.{databaseId}`
Schema	`redshift:{clusterId}.{region}.{port}.{databaseId}.{schemaId}`
Tabella	`redshift:{clusterId}.{region}.{port}.{databaseId}.{schemaId}.{tableId}`

AWS S3

Risorsa	Formato
Bucket	`s3:{bucket}`
Percorso	`s3:{bucket}.{virtualPath}`

AWS Glue

Risorsa	Formato
Tabella	`aws_glue:table:{region}.{accountId}.{dbName}.{tableName}`

Azure Blob Storage

Risorsa	Formato
Account	`abs:{account}`
Container	`abs:{account}.{container}`
Percorso	`abs:{account}.{container}.{virtualPath}`

Azure Cosmos DB

Risorsa	Formato
Account	`cosmos-db:{accountName}`
Database	`cosmos-db:{accountName}.{databaseId}`
Container	`cosmos-db:{accountName}.{databaseId}.{containerId}`

Azure Data Explorer

Risorsa	Formato
Cluster	`kusto:{clusterName}.{region}`
Database	`kusto:{clusterName}.{region}.{databaseId}`
Tabella	`kusto:{clusterName}.{region}.{databaseId}.{tableId}`

Databricks

Risorsa	Formato
Metastore	`databricks:{metastoreId}`
Catalogo	`databricks:{metastoreId}.{catalogId}`
Schema	`databricks:{metastoreId}.{catalogId}.{schemaId}`
Tabella	`databricks:table:{metastoreId}.{catalogId}.{schemaId}.{tableId}`
Visualizza	`databricks:view:{metastoreId}.{catalogId}.{schemaId}.{viewId}`
Routine	`databricks:routine:{metastoreId}.{catalogId}.{schemaId}.{routineId}`
Volume	`databricks:volume:{metastoreId}.{catalogId}.{schemaId}.{volumeId}`
Modello	`databricks:model:{metastoreId}.{catalogId}.{schemaId}.{modelId}`

Databricks File System

Risorsa	Formato
Istanza	`dbfs:{workspace}`
Percorso	`dbfs:{workspace}.{path}`

File system generico

Risorsa	Formato
Istanza	`filesystem:{dns}`
Percorso	`filesystem:{dns}.{path}`

File system distribuito Hadoop

Risorsa	Formato
Istanza	`hdfs:{dns}`
Percorso	`hdfs:{dns}.{path}`

IBM DB2

Risorsa	Formato
Istanza	`db2:{dns}`
Database	`db2:{dns}.{databaseId}`
Schema	`db2:{dns}.{databaseId}.{schemaId}`
Tabella	`db2:{dns}.{databaseId}.{schemaId}.{tableId}`

IBM Informix

Risorsa	Formato
Istanza	`informix:{dns}`
Database	`informix:{dns}.{databaseId}`
Schema	`informix:{dns}.{databaseId}.{schemaId}`
Tabella	`informix:{dns}.{databaseId}.{schemaId}.{tableId}`

Microsoft SQL Server

Risorsa	Formato
Istanza	`sqlserver:{dns}`
Database	`sqlserver:{dns}.{databaseId}`
Schema	`sqlserver:{dns}.{databaseId}.{schemaId}`
Tabella	`sqlserver:{dns}.{databaseId}.{schemaId}.{tableId}`

MySQL

Risorsa	Formato
Istanza	`mysql:{dns}`
Schema	`mysql:{dns}.{schemaId}`
Tabella	`mysql:{dns}.{schemaId}.{tableId}`

Database Oracle

Risorsa	Formato
Istanza	`oracle:{dns}`
Database	`oracle:{dns}.{databaseId}`
Schema	`oracle:{dns}.{databaseId}.{schemaId}`
Tabella	`oracle:{dns}.{databaseId}.{schemaId}.{tableId}`

PostgreSQL

Risorsa	Formato
Istanza	`postgresql:{dns}`
Database	`postgresql:{dns}.{databaseId}`
Schema	`postgresql:{dns}.{databaseId}.{schemaId}`
Tabella	`postgresql:{dns}.{databaseId}.{schemaId}.{tableId}`

Salesforce

Risorsa	Formato
SObject	`salesforce:{environment}.{orgId}.{sobject}`

Snowflake

Risorsa	Formato
Account	`snowflake:{accountName}`
Database	`snowflake:{accountName}.{databaseId}`
Schema	`snowflake:{accountName}.{databaseId}.{schemaId}`
Tabella	`snowflake:{accountName}.{databaseId}.{schemaId}.{tableId}`

Tableau

Risorsa	Formato
Server	`tableau:{dns}`
Sito	`tableau:{dns}.{site}`
Progetto	`tableau:project:{dns}.{site}.{projectId}`
Origine dati	`tableau:datasource:{dns}.{site}.{projectId}.{datasourceId}`
Foglio di lavoro	`tableau:workbook:{dns}.{site}.{projectId}.{workbookId}`
Foglio	`tableau:sheet:{dns}.{site}.{projectId}.{workbookId}.{sheetId}`
Dashboard	`tableau:dashboard:{dns}.{site}.{projectId}.{workbookId}.{dashboardId}`

Trino

Risorsa	Formato
Istanza	`trino:{dns}`
Catalogo	`trino:{dns}.{catalogId}`
Schema	`trino:{dns}.{catalogId}.{schemaId}`
Tabella	`trino:{dns}.{catalogId}.{schemaId}.{tableId}`

Formati personalizzati

Puoi creare un formato del nome completo personalizzato utilizzando il prefisso custom:. I formati personalizzati non vengono convalidati e potrebbero non essere compatibili con le funzionalità di Knowledge Catalog. Per semplificare la migrazione futura, crea formati personalizzati simili a quelli predefiniti.

Le risorse a cui viene fatto riferimento nei messaggi OpenLineage con lo spazio dei nomi custom vengono interpretate come nomi completi personalizzati.