Visualiza fichas y suscríbete a ellas

Como suscriptor de Analytics Hub, puedes ver y suscribirte a fichas a las que tienes acceso. Cuando te suscribes a una ficha, se crea un conjunto de datos vinculado en tu proyecto.

Funciones obligatorias

Para obtener los permisos que necesitas a fin de usar fichas, pídele a tu administrador que te otorgue los siguientes roles de Identity and Access Management (IAM):

Para suscribirte a fichas, también debes pedirle al publicador de fichas que te otorgue el rol Suscriptor de Analytics Hub (roles/analyticshub.subscriber) en su ficha, intercambio o proyecto, el permiso más apropiado para tu caso de uso.

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso.

Estos roles predefinidos contienen los permisos necesarios para realizar las tareas de este documento. A fin de ver los permisos exactos necesarios para crear y consultar conjuntos de datos, expande la sección Permisos necesarios:

Permisos necesarios

  • Crear conjuntos de datos nuevos: bigquery.datasets.create o bigquery.datasets.* para realizar acciones adicionales en los conjuntos de datos.
  • Consultar conjuntos de datos: bigquery.jobs.create o bigquery.jobs.* para realizar acciones adicionales en los trabajos.

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

Descubre fichas

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

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

    Ir a BigQuery

  2. En el panel Explorador, haz clic en Agregar datos.

  3. En el cuadro de diálogo Agregar datos, haz clic en Analytics Hub. Aparecerá el cuadro de diálogo de Analytics Hub que contiene fichas a las que puedes acceder. Para las fichas de Salesforce Data Cloud, hay un botón en el panel Explorador que filtra de forma automática las fichas relacionadas.

    Como alternativa, para abrir el cuadro de diálogo de Analytics Hub, puedes ir a Analytics Hub y hacer clic en Buscar fichas.

  4. Para filtrar las fichas por su nombre o descripción, ingresa el nombre o la descripción de la ficha en el campo Buscar fichas.

  5. En la sección Filtro, puedes filtrar las fichas según los siguientes campos:

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

    • Categorías: Selecciona las categorías deseadas.

    • Ubicación: Selecciona la ubicación deseada. Para obtener más información, consulta Regiones admitidas.

    • Proveedor: Selecciona el 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.

  6. Explora las fichas 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.

Para suscribirte a una ficha, sigue estos pasos:

Consola

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

  2. Explora las fichas y haz clic en una a la que desees suscribirte. Aparecerá un cuadro de diálogo con los detalles de la ficha.

  3. Si no tienes acceso para suscribirte a una ficha, como una ficha que haga referencia a un conjunto de datos comerciales, haz clic en Solicitar acceso. Si haces clic en un conjunto de datos al que puedes suscribirte, haz clic en Agregar conjunto de datos al proyecto para abrir el cuadro de diálogo Crear conjunto de datos vinculado.

  4. Si no tienes habilitada la API de Analytics Hub en tu proyecto, aparecerá un mensaje de error con un vínculo para habilitar la API. Haz clic en Habilitar la API de Analytics Hub.

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

    • Proyecto: Especifica el nombre del proyecto al que deseas agregar el conjunto de datos.
    • Nombre del conjunto de datos vinculado: Especifica el nombre del conjunto de datos vinculado.

  6. Para guardar los cambios, haz clic en Guardar. El conjunto de datos vinculado se muestra en tu proyecto.

API

Usa el método projects.locations.dataExchanges.listings.subscribe.

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

Reemplaza lo siguiente:

  • PROJECT_ID: el ID del proyecto de la ficha a la que deseas suscribirte.
  • LOCATION: la ubicación de la ficha a la que deseas suscribirte.
  • DATAEXCHANGE_ID: el ID del intercambio de datos de la ficha a la que deseas suscribirte.
  • LISTING_ID: el ID de la ficha a la que deseas suscribirte.

En el cuerpo de la solicitud, especifica el conjunto de datos en el que deseas crear el conjunto de datos vinculados. Si se ejecuta correctamente, el cuerpo de la respuesta está vacío.

Visualiza conjuntos de datos vinculados

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

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

Consola

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

    Ir a BigQuery

  2. En el panel Explorador, haz clic en el nombre del proyecto que contiene el conjunto de datos vinculado .

También puedes usar Data Catalog para buscar y ver conjuntos de datos vinculados. Para que coincidan todos los conjuntos de datos vinculados de Analytics Hub, usa el predicado type=dataset.linked. Para obtener más información, consulta Sintaxis de búsqueda de Data Catalog.

Cloud Shell

Ejecute el siguiente comando:

PROJECT=<your 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

Actualiza los conjuntos de datos vinculados

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

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 consola de Google Cloud, ve a la página de BigQuery.

    Ir a BigQuery

  2. En el panel Explorador, haz clic en el nombre de tu proyecto y, luego, en el conjunto de datos vinculado.

  3. Expande la opción Acciones y haz clic en Abrir.

  4. En el panel Detalles, haz clic en Editar detalles y, luego, especifica los siguientes detalles:

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

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

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

  5. Haz clic en Guardar.

Visualiza los metadatos de tablas

Para ver los metadatos de la tabla subyacente, consulta la vista INFORMATION_SCHEMA.TABLES:

SELECT * FROM `LINKED-DATASET.INFORMATION_SCHEMA.TABLES`

Reemplaza LINKED-DATASET por el nombre del conjunto de datos vinculado.

Borrar conjuntos de datos vinculados

Si un publicador de Analytics Hub quita tu suscripción, se desvinculará tu conjunto de datos vinculado del conjunto de datos compartido. Puedes borrar un conjunto de datos no vinculado porque no puedes consultar un conjunto de datos no vinculado.

Borrar un conjunto de datos vinculado no borra el conjunto de datos de origen. No puedes recuperar un conjunto de datos vinculado que borraste. Sin embargo, puedes volver a crearlo si te suscribes a la ficha otra vez y agregas el conjunto de datos a tu proyecto.

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

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

    Ir a BigQuery

  2. En el panel Explorador, haz clic en el nombre de tu proyecto y, luego, en el conjunto de datos vinculado.

  3. Expande la opción Acciones y haz clic en Borrar.

  4. En el cuadro de diálogo ¿Borrar conjunto de datos vinculado?, escribe borrar para confirmar la eliminación.

  5. Haz clic en Borrar.

¿Qué sigue?