Alterações aos metadados armazenados no Dataplex Universal Catalog

Entre 12 de janeiro de 2026 e 2 de fevereiro de 2026, alguns dos metadados armazenados no Dataplex Universal Catalog vão mudar.

Esta alteração torna os metadados armazenados no catálogo universal do Dataplex consistentes com os metadados dos sistemas de origem originais.

Se as suas cargas de trabalho se enquadrarem no âmbito das alterações descritas na secção seguinte, siga as instruções neste documento.

Âmbito das alterações

As alterações descritas nesta secção aplicam-se a entradas dos seguintes sistemas de origem:

  • Vertex AI
  • Bigtable
  • Spanner
  • Pub/Sub
  • Dataform
  • Dataproc Metastore

Os seguintes métodos da API Dataplex são afetados por estas alterações:

Nomes de recursos

O nome do recurso é alterado para o campo de entrada de nível superior entrySource.resource. O campo é modificado para conter um nome de recurso relativo em vez do nome de recurso completo com a API. O prefixo //<service_name>.googleapis.com/ é removido do nome do recurso. A tabela seguinte apresenta alguns exemplos.

Sistema de origem Valor antes da alteração Valor após a alteração
Vertex AI //aiplatform.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/REMAINING_PATH
Exemplo: //aiplatform.googleapis.com/projects/test-project-id/locations/us-central1/featureOnlineStores/test-store		 projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/REMAINING_PATH
Exemplo: projects/test-project-id/locations/us-central1/featureOnlineStores/test-store
Bigtable //bigtable.googleapis.com/projects/PROJECT_ID/instances/INSTANCE_ID/tables/TABLE_ID
Exemplo: //bigtable.googleapis.com/projects/test-project-id/instances/test-instance/tables/test-table		 projects/PROJECT_ID/instances/INSTANCE_ID/tables/TABLE_ID
Exemplo: projects/test-project-id/instances/test-instance/tables/test-table
Spanner //spanner.googleapis.com/projects/PROJECT_ID/instances/INSTANCE_ID/databases/DATABASE_ID
Exemplo: //spanner.googleapis.com/projects/test-project-id/instances/test-instance/databases/test-database		 projects/PROJECT_ID/instances/INSTANCE_ID/databases/DATABASE_ID
Exemplo: projects/test-project-id/instances/test-instance/databases/test-database
Pub/Sub //pubsub.googleapis.com/projects/PROJECT_ID/topics/TOPIC_ID
Exemplo: //pubsub.googleapis.com/projects/test-project-id/topics/test-topic		 projects/PROJECT_ID/topics/TOPIC_ID
Exemplo: projects/test-project-id/topics/test-topic
Dataform //dataform.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/repositories/REPOSITORY_ID
Exemplo: //dataform.googleapis.com/projects/test-project-id/locations/us-central1/repositories/test-repo		 projects/PROJECT_ID/locations/LOCATION_ID/repositories/REPOSITORY_ID
Exemplo: projects/test-project-id/locations/us-central1/repositories/test-repo
Dataproc Metastore //metastore.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/services/SERVICE_ID
Exemplo: //metastore.googleapis.com/projects/test-project-id/locations/us-central1/services/test-service		 projects/PROJECT_ID/locations/LOCATION_ID/services/SERVICE_ID
Exemplo: projects/test-project-id/locations/us-central1/services/test-service

Para mais informações sobre este campo, consulte a EntrySource referência da API.

Valores do tipo de elemento principal

O campo de entrada de nível superior entrySource.ancestors.type muda para conter o ID do projeto do tipo Dataplex (dataplex-types) em vez do número do projeto do tipo Dataplex (655216118709). A tabela seguinte apresenta alguns exemplos.

Sistema de origem Valor antes da alteração Valor após a alteração
Vertex AI DATAPLEX_TYPE_PROJECT_NUMBER.global.vertexai-feature-online-store
Exemplo: 655216118709.global.vertexai-feature-online-store		 DATAPLEX_TYPE_PROJECT_ID.global.vertexai-feature-online-store
Exemplo: dataplex-types.global.vertexai-feature-online-store
Dataproc Metastore DATAPLEX_TYPE_PROJECT_NUMBER.global.DataprocMetastoreDatabase
Exemplo: 655216118709.global.DataprocMetastoreDatabase		 DATAPLEX_TYPE_PROJECT_ID.global.dataproc-metastore-database
Exemplo: dataplex-types.global.dataproc-metastore-database
Spanner DATAPLEX_TYPE_PROJECT_NUMBER.global.cloud-spanner-instance
Exemplo: 655216118709.global.cloud-spanner-instance		 DATAPLEX_TYPE_PROJECT_ID.global.cloud-spanner-instance
Exemplo: dataplex-types.global.cloud-spanner-instance
Bigtable DATAPLEX_TYPE_PROJECT_NUMBER.global.cloud-bigtable-instance
Exemplo: 655216118709.global.cloud-bigtable-instance		 DATAPLEX_TYPE_PROJECT_ID.global.cloud-bigtable-instance
Exemplo: dataplex-types.global.cloud-bigtable-instance

Para mais informações sobre este campo, consulte a Ancestor referência da API.

O que tem de fazer

O período de implementação começa a 12 de janeiro de 2026 e termina a 2 de fevereiro de 2026. As alterações aos metadados aplicam-se gradualmente durante o período de implementação.

Saiba o que tem de fazer:

  • Antes de 12 de janeiro de 2026, atualize as suas cargas de trabalho para interpretarem a versão antiga dos metadados e a versão atualizada dos metadados.

  • Durante o período de implementação, as entradas podem captar a versão antiga dos metadados ou a versão atualizada dos metadados. As suas cargas de trabalho têm de conseguir interpretar ambas as versões.

  • Após 2 de fevereiro de 2026, atualize opcionalmente as suas cargas de trabalho para interpretarem apenas a nova versão dos metadados.

Como determinar a versão dos metadados

Para determinar se uma entrada usa os metadados atualizados, procure o objeto aspects da entrada e localize o tipo de aspeto relevante. No objeto aspectSource do tipo de aspeto, se o campo dataVersion estiver presente e definido como Ingestion/1.0.0, a entrada usa a versão atualizada dos metadados. Para mais informações, consulte as APIs lookupEntry e getAspectType.

Apoio técnico

Para questões, contacte dataplex-msa-support@google.com.

Informações adicionais