Visualiza fichas e intercambios de datos, y suscríbete a ellos

En BigQuery sharing (anteriormente Analytics Hub), puedes descubrir fichas e intercambios de datos, y suscribirte a ellos para consultar datos compartidos directamente en BigQuery sin replicar datos ni incurrir en costos de almacenamiento. Cuando te suscribes, se crean conjuntos de datos vinculados de solo lectura en tu proyecto que te permiten analizar tablas y vistas compartidas junto con tus recursos existentes.

Roles obligatorios

Para obtener los permisos que necesitas a fin de usar fichas, pídele a tu administrador que te otorgue los siguientes roles de IAM:

• Descubre fichas e intercambios de datos: Visualizador de Analytics Hub (roles/analyticshub.viewer) en el proyecto del suscriptor
• Suscríbete a fichas:
  • Usuario de BigQuery (roles/bigquery.user) en el proyecto del suscriptor
  • Suscriptor de Analytics Hub (roles/analyticshub.subscriber) en la ficha, el intercambio o el proyecto del publicador
• Suscríbete a intercambios de datos:
  • Usuario de BigQuery (roles/bigquery.user) en el proyecto del suscriptor
  • Suscriptor de Analytics Hub (roles/analyticshub.subscriber) en la sala limpia de datos
  • Rol de propietario de la suscripción a Analytics Hub (roles/analyticshub.subscriptionOwner) en el proyecto de destino
• Visualiza y consulta conjuntos de datos vinculados: Visualizador de datos de BigQuery (roles/bigquery.dataViewer) en el proyecto del suscriptor
• Visualiza metadatos de la tabla: Visualizador de datos de BigQuery (roles/bigquery.dataViewer) en el proyecto del suscriptor
• Actualiza conjuntos de datos vinculados: Propietario de datos de BigQuery (roles/bigquery.dataOwner) en el proyecto del suscriptor
• Borra conjuntos de datos vinculados: Administrador de BigQuery (roles/bigquery.admin) en el proyecto del suscriptor

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Estos roles predefinidos contienen los permisos necesarios para usar fichas. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para usar fichas:

• Crea conjuntos de datos nuevos: bigquery.datasets.create en el proyecto del suscriptor
• Consulta conjuntos de datos: bigquery.jobs.create en el proyecto del suscriptor

También puedes obtener estos permisos con roles personalizados o otros roles predefinidos.

Descubre fichas

Para descubrir fichas públicas y privadas, sigue estos pasos:

1. En la Google Cloud consola de, ve a la página Uso compartido (Analytics Hub).

   Ir a Uso compartido (Analytics Hub)

2. Haz clic en Buscar fichas. Aparecerá un diálogo que contiene fichas a las que puedes acceder.

3. Para filtrar las fichas por nombre o descripción, ingresa el texto en el campo Buscar fichas.

4. En la sección Filtros, filtra las fichas con los siguientes campos:

   • Fichas: Selecciona si deseas ver fichas privadas, fichas públicas fichas o fichas dentro de tu organización.

   • Categorías: Selecciona una o más categorías.

   • Ubicación: Selecciona una ubicación. Solo puedes buscar por la ubicación del intercambio de datos. Para obtener más información, consulta Regiones admitidas.

   • Proveedor: Selecciona un proveedor de datos. Algunos proveedores de datos requieren que solicites acceso a sus conjuntos de datos comerciales. Después de solicitar acceso, el proveedor de datos se comunicará contigo para compartir sus conjuntos de datos.

5. Explora las fichas filtradas.

Descubre intercambios de datos

Para descubrir intercambios de datos, sigue estos pasos:

1. En la Google Cloud consola de, ve a la página Uso compartido (Analytics Hub).

   Ir a Uso compartido (Analytics Hub)

2. Haz clic en Buscar fichas. Aparecerá un diálogo que contiene fichas e intercambios de datos a los que puedes suscribirte.

3. Para filtrar los intercambios de datos por nombre o descripción, ingresa el texto en el campo Buscar fichas.

4. En la sección Filtros, filtra los intercambios de salas limpias de datos con los siguientes campos:

   • Fichas: Selecciona la casilla de verificación Salas limpias para ver las salas limpias compartidas.

   • Categorías: Selecciona una o más categorías.

   • Ubicación: Selecciona una ubicación. Solo puedes buscar por la ubicación del intercambio de datos. Para obtener más información, consulta Regiones admitidas.

5. Explora las salas limpias de datos filtradas.

Suscríbete a fichas

Suscribirse a una ficha te brinda acceso de solo lectura a los datos de la ficha mediante la creación de un conjunto de datos vinculados en tu proyecto.

Precaución: Evita colocar datos en un proyecto que esté dentro de un perímetro de Controles del servicio de VPC. Si tu proyecto está dentro de un perímetro, agrega las reglas de entrada y salida adecuadas.

Para suscribirte a una ficha, sigue estos pasos:

Console

1. Para ver una lista de las fichas a las que tienes acceso, sigue los pasos que se indican en Descubre fichas.

2. En la lista de fichas, haz clic en la ficha a la que deseas suscribirte. Aparecerá un diálogo con los detalles de la ficha. El diálogo indica si el proveedor habilitó el registro de correo electrónico del suscriptor y enumera las regiones en las que está disponible la ficha.

3. Si la ficha requiere aprobación o compra (como un conjunto de datos comerciales), haz clic en Solicitar acceso o Comprar a través de Marketplace. De lo contrario, haz clic en Suscribirse para abrir el diálogo Crear conjunto de datos vinculado.

4. Si la API de Analytics Hub no está habilitada en tu proyecto, haz clic en Habilitar la API de Analytics Hub en el mensaje que aparece.

5. En el diálogo Crear conjunto de datos vinculado, especifica los siguientes detalles:

   • Proyecto: Ingresa el nombre del proyecto en el que deseas agregar el conjunto de datos.
   • Nombre del conjunto de datos vinculado: Ingresa un nombre para el conjunto de datos vinculado.

   • Región principal: Selecciona la región en la que deseas crear el conjunto de datos vinculado.

     Nota: No es necesario que la región principal coincida con la región principal del proveedor. Puedes colocar tu conjunto de datos vinculado en la región del proveedor para minimizar la latencia de replicación.

   • Opcional: Regiones de réplica: Selecciona las regiones en las que deseas crear réplicas de conjuntos de datos vinculados. Colocar tu conjunto de datos vinculado con otros datos minimiza la salida y facilita las uniones entre conjuntos de datos. Para crear réplicas, debes tener el permiso bigquery.datasets.update en el conjunto de datos vinculado.

   Nota: El sistema intenta crear réplicas de conjuntos de datos vinculados, pero, si falta el permiso bigquery.datasets.update en el conjunto de datos vinculado, no se crean réplicas.

6. Para crear el conjunto de datos vinculado, haz clic en Guardar.

API

Para suscribirte a una ficha, llama al projects.locations.dataExchanges.listings.subscribe método:

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID:subscribe

Reemplaza lo siguiente:

• PROJECT_ID: el Google Cloud ID del proyecto que contiene la ficha a la que deseas suscribirte.
• LOCATION: la ubicación de la ficha.
• DATAEXCHANGE_ID: el ID del intercambio de datos de la ficha.
• LISTING_ID: el ID de la ficha a la que deseas suscribirte.
• SUBSCRIBER_PROJECT_ID: el Google Cloud ID del proyecto del suscriptor en el que deseas crear el conjunto de datos vinculado.
• LINKED_DATASET_ID: el ID que deseas asignar al conjunto de datos vinculado.
• PRIMARY_REGION: la región geográfica principal en la que deseas crear el conjunto de datos vinculado.

En el cuerpo de la solicitud, especifica el conjunto de datos en el que deseas crear el conjunto de datos vinculados:

{
"destinationDataset": {
  "datasetReference": {
    "projectId": "SUBSCRIBER_PROJECT_ID",
    "datasetId": "LINKED_DATASET_ID"
  },
  "location": "PRIMARY_REGION"
}
}

Para crear una suscripción con réplicas de conjuntos de datos vinculados en varias regiones, especifica la región principal en el campo location. Para especificar regiones de réplica secundarias, agrega las regiones al campo destinationDataset.replica_locations. Asegúrate de que todas las regiones especificadas sean regiones en las que esté disponible la ficha.

Nota: El sistema intenta crear réplicas de conjuntos de datos vinculados, pero, si falta el permiso bigquery.datasets.update en el conjunto de datos vinculado, no se crean réplicas.

Si la solicitud se realiza correctamente, el cuerpo de la respuesta contendrá el objeto de suscripción.

Si habilitas el registro de correo electrónico del suscriptor para el intercambio de datos o la ficha con el campo logLinkedDatasetQueryUserEmail, la respuesta de la suscripción contendrá log_linked_dataset_query_user_email: true. Los datos registrados están disponibles en el job_principal_subject campo de la INFORMATION_SCHEMA.SHARED_DATASET_USAGE vista.

Si habilitas el uso compartido de procedimientos almacenados (vista previa), la respuesta de la ficha contendrá stored_procedure_config: true.

Nota: Para ejecutar procedimientos almacenados compartidos en un conjunto de datos vinculado, debes autorizar que los procedimientos almacenados compartidos accedan a los recursos de tu proyecto.

Suscríbete a intercambios de datos

Suscribirse a un intercambio de datos te brinda acceso de solo lectura a los datos en el intercambio de datos a través de la creación de un conjunto de datos vinculado en tu proyecto.

Para suscribirte a un intercambio de salas limpias de datos, sigue estos pasos:

Console

1. Para ver una lista de los intercambios de salas limpias de datos a los que tienes acceso, sigue los pasos que se indican en Descubre intercambios de datos.

2. En la lista de salas limpias de datos, haz clic en el intercambio de salas limpias de datos al que deseas suscribirte. Aparecerá un diálogo con los detalles del intercambio de salas limpias de datos.

3. Haz clic en Suscribirse para abrir el diálogo Agregar sala limpia de datos al proyecto.

4. Si la API de Analytics Hub no está habilitada en tu proyecto, haz clic en Habilitar la API de Analytics Hub en el mensaje que aparece.

5. En el diálogo Agregar sala limpia de datos al proyecto, especifica los siguientes detalles:

   • Destino: Ingresa el nombre del proyecto en el que deseas agregar el conjunto de datos.

6. Para crear el conjunto de datos vinculado, haz clic en Guardar.

API

Para suscribirte a un intercambio de salas limpias de datos, llama al projects.locations.dataExchanges.subscribe método:

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID:subscribe

Reemplaza lo siguiente:

• PROJECT_ID: el Google Cloud ID del proyecto que contiene el intercambio de datos al que deseas suscribirte.
• LOCATION: la ubicación del intercambio de datos.
• DATAEXCHANGE_ID: el ID del intercambio de datos.
• SUBSCRIBER_PROJECT_ID: el Google Cloud ID del proyecto del suscriptor en el que deseas crear el conjunto de datos vinculado.
• SUBSCRIPTION_ID: el nombre de la suscripción que se creará.
• LINKED_DATASET_ID: el ID que deseas asignar al conjunto de datos vinculado.
• PRIMARY_REGION: la región geográfica principal en la que deseas crear el conjunto de datos vinculado.

En el cuerpo de la solicitud, especifica la ubicación de destino, el nombre de la suscripción y el conjunto de datos en el que deseas crear el conjunto de datos vinculados:

{
"destination": "projects/SUBSCRIBER_PROJECT_ID/locations/LOCATION",
"subscription": "SUBSCRIPTION_ID",
"destinationDataset": {
  "datasetReference": {
    "projectId": "SUBSCRIBER_PROJECT_ID",
    "datasetId": "LINKED_DATASET_ID"
  },
  "location": "PRIMARY_REGION"
}
}

Si la solicitud se realiza correctamente, el cuerpo de la respuesta contendrá el objeto de operación. Si habilitaste el registro de correo electrónico del suscriptor para el intercambio de datos, la respuesta de la suscripción contendrá log_linked_dataset_query_user_email: true.

Visualiza conjuntos de datos vinculados

Los conjuntos de datos vinculados se muestran junto con otros conjuntos de datos en la Google Cloud consola.

Para ver los conjuntos de datos vinculados en tu proyecto, sigue estos pasos:

Console

1. En la Google Cloud consola de, ve a la página BigQuery.

   Ir a BigQuery

2. En el panel Explorador clásico, haz clic en la categoría Explorador clásico:

   

   Si el panel Explorador clásico no está visible, haz clic en Expandir panel izquierdo para abrir el panel.

3. En el panel Explorador clásico, haz clic en el nombre del proyecto que contiene el conjunto de datos vinculado.

Como alternativa, puedes buscar y ver conjuntos de datos vinculados con Knowledge Catalog. Para que coincidan todos los conjuntos de datos vinculados de BigQuery sharing en tu consulta de búsqueda, usa el predicado type=dataset.linked. Para obtener más información, consulta Sintaxis de búsqueda de Knowledge Catalog.

Cloud Shell

Para enumerar los conjuntos de datos vinculados en tu proyecto con la herramienta de línea de comandos de bq, ejecuta el siguiente comando en Cloud Shell:

PROJECT=PROJECT_ID \
for dataset in $(bq ls --project_id $PROJECT | tail +3); do [ "$(bq show -d --project_id $PROJECT $dataset | egrep LINKED)" ] && echo $dataset; done

Reemplaza PROJECT_ID por el ID del Google Cloud proyecto.

Nota: Si un publicador quita una suscripción, la página de detalles del conjunto de datos vinculado indica que el conjunto de datos está desvinculado. Como no puedes consultar un conjunto de datos no vinculado, puedes borrarlo.

Consulta conjuntos de datos vinculados

Puedes consultar tablas y vistas en tus conjuntos de datos vinculados de la misma manera que lo harías con cualquier otra tabla de BigQuery.

Para consultar una tabla en un conjunto de datos vinculado, ejecuta una consulta SELECT que haga referencia al ID de tu proyecto, al ID del conjunto de datos vinculado y al nombre de la tabla:

SELECT * FROM `PROJECT_ID`.`LINKED_DATASET_ID`.`TABLE_NAME`
LIMIT 10;

Reemplaza lo siguiente:

• PROJECT_ID: el Google Cloud ID del proyecto.
• LINKED_DATASET_ID: el ID del conjunto de datos vinculado.
• TABLE_NAME: el nombre de la tabla o la vista que deseas consultar.

Para obtener más información, consulta Ejecuta consultas interactivas.

Actualiza conjuntos de datos vinculados

Los recursos de un conjunto de datos vinculados son de solo lectura. No puedes editar los datos ni los metadatos de los recursos en conjuntos de datos vinculados, ni especificar permisos para recursos individuales.

Solo puedes actualizar la descripción y las etiquetas de tus conjuntos de datos vinculados. Los cambios en un conjunto de datos vinculado no afectan a los conjuntos de datos de origen o compartidos.

Para actualizar la descripción y las etiquetas de un conjunto de datos vinculado, sigue estos pasos:

1. En la Google Cloud consola de, ve a la página BigQuery.

   Ir a BigQuery

2. En el panel Explorador, haz clic en Explorador:

   

3. En el panel Explorador, expande el nombre de tu proyecto, haz clic en Conjuntos de datos y luego, en el nombre del conjunto de datos vinculado para abrirlo.

4. En el panel de detalles, haz clic en Editar detalles y configura las siguientes opciones:

   1. Para agregar etiquetas, consulta Agrega una etiqueta a un conjunto de datos.

   2. Para habilitar la intercalación, expande Opciones avanzadas y sigue estos pasos:

      1. Elige Habilitar intercalación predeterminada.
      2. En la lista Intercalación predeterminada, elige una opción.

5. Para guardar los cambios, haz clic en Guardar.

Visualiza los metadatos de tablas

Para ver los metadatos de la tabla de un conjunto de datos vinculado, consulta la INFORMATION_SCHEMA.TABLES vista:

SELECT * FROM `LINKED_DATASET_ID`.INFORMATION_SCHEMA.TABLES;

Reemplaza LINKED_DATASET_ID por el ID del conjunto de datos vinculado.

Nota: Las consultas INFORMATION_SCHEMA basadas en regiones no muestran metadatos de tablas vinculadas. Para obtener más información sobre las vistas no compatibles, consulta Limitaciones.

Anula la suscripción a conjuntos de datos vinculados o bórralos

Para anular la suscripción a un conjunto de datos, borra el conjunto de datos vinculado. Borrar un conjunto de datos vinculado no borra el conjunto de datos de origen.

No puedes recuperar un conjunto de datos vinculado después de borrarlo. Sin embargo, puedes volver a crear el conjunto de datos vinculado borrado en cualquier momento si te suscribes a la ficha otra vez.

Si un publicador quita tu suscripción, se desvinculará tu conjunto de datos vinculado del conjunto de datos compartido. Como esta es una acción iniciada por el publicador en un recurso propiedad del suscriptor, el conjunto de datos vinculado permanece en tu proyecto en un estado desvinculado. Puedes quitar el conjunto de datos desvinculado borrándolo.

Para borrar un conjunto de datos vinculados, haz lo siguiente:

1. En la Google Cloud consola de, ve a la página BigQuery.

   Ir a BigQuery

2. En el panel Explorador, haz clic en Explorador:

   

3. En el panel Explorador, expande el nombre de tu proyecto, haz clic en Conjuntos de datos y luego, en el nombre del conjunto de datos vinculado para abrirlo.

4. Haz clic en Borrar.

5. En el diálogo ¿Borrar conjunto de datos vinculado?, ingresa delete para confirmar la eliminación.

6. Haz clic en Borrar.

¿Qué sigue?

• Obtén información sobre BigQuery sharing.
• Obtén información sobre cómo administrar fichas.
• Obtén información sobre cómo administrar los intercambios de datos.
• Obtén información para ver los registros de auditoría de BigQuery sharing.