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.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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.