Administra fichas

Como publicador de BigQuery sharing, puedes hacer lo siguiente en BigQuery sharing (anteriormente Analytics Hub):

  • Crear fichas en un intercambio de datos para el que tengas acceso de publicación.
  • Actualiza, borra, comparte y visualiza métricas de uso para las fichas.
  • Administrar diferentes roles de uso compartido de BigQuery para tus fichas, como administradores de fichas, suscriptores y visualizadores
  • Visualizar todos los suscriptores que se suscribieron a tu ficha.
  • Supervisa el uso de tus fichas.
  • Quitar suscriptores de tu ficha.

Una ficha es una referencia a un conjunto de datos compartidos que un publicador anuncia en un intercambio de datos. Una ficha puede ser de los siguientes dos tipos según la política de Identity and Access Management (IAM) que se configura para la ficha y el tipo de intercambio de datos que contiene la ficha:

Antes de comenzar

Para comenzar a usar BigQuery sharing (anteriormente Analytics Hub), debes habilitar la API de Analytics Hub en tu Google Cloud proyecto.

Para habilitar la API de Analytics Hub, necesitas los siguientes permisos de Identity and Access Management (IAM):

  • serviceUsage.services.get
  • serviceUsage.services.list
  • serviceUsage.services.enable

El siguiente rol predefinido de IAM incluye los permisos que necesitas para habilitar la API de Analytics Hub:

Para habilitar la API de Analytics Hub, selecciona una de las siguientes opciones:

Console

Ve a la página de la API de Analytics Hub y habilita la API de Analytics Hub para tu proyecto Google Cloud .

Habilita la API de Analytics Hub

gcloud

Ejecuta el comando gcloud services enable:

gcloud services enable analyticshub.googleapis.com

Roles obligatorios

Para administrar las fichas y las suscripciones, debes tener uno de los siguientes roles de Identity and Access Management (IAM) para compartir de BigQuery:

  • Rol Analytics Hub Publisher (roles/analyticshub.publisher), que te permite crear, actualizar, borrar y configurar políticas de IAM en tus fichas.

  • Rol Analytics Hub Listing Admin (roles/analyticshub.listingAdmin), que te permite actualizar, borrar y configurar políticas de IAM en tus fichas.

  • Rol Analytics Hub Admin (roles/analyticshub.admin), que te permite crear, actualizar, borrar y establecer políticas de IAM en todas las fichas de tu intercambio de datos.

Para obtener más información, consulta Roles de IAM para compartir datos en BigQuery. Para obtener información sobre cómo otorgar estos roles a otros usuarios, consulta Crea un administrador de fichas.

Además, para crear fichas, también debes tener los permisos bigquery.datasets.get y bigquery.datasets.update para los conjuntos de datos en los que deseas crear fichas. Los siguientes roles predefinidos de BigQuery contienen el permiso bigquery.datasets.update:

Para ver todos los intercambios de datos de proyectos en una organización a la que tienes acceso, debes tener el permiso resourcemanager.organizations.get. No hay roles predefinidos de BigQuery que contengan este permiso, por lo que deberías usar un rol personalizado de IAM.

Ve los intercambios de datos

Para ver la lista de intercambios de datos de tu organización a los que tienes acceso, consulta Ver intercambios de datos. Si el intercambio de datos está en otra organización, el administrador de BigQuery sharing debe compartir un vínculo a ese intercambio de datos contigo.

Crea una ficha

Una ficha es una referencia a un conjunto de datos compartido que un publicador de uso compartido de BigQuery anuncia en un intercambio de datos.

Para crear una ficha, sigue estos pasos:

Console

  1. Ve a la página Uso compartido (Analytics Hub).

    Ir a Uso compartido (Analytics Hub)

    Aparecerá una página que enumera todos los intercambios de datos a los que puedes acceder.

  2. Haz clic en el nombre del intercambio de datos en el que deseas crear la ficha.

  3. Haz clic en Crear ficha.

  4. En la sección Configurar datos, en el menú Tipo de recurso, selecciona Conjunto de datos de BigQuery o Tema de Pub/Sub.

    • Si seleccionas Conjunto de datos de BigQuery, haz lo siguiente:

      1. En el menú Conjunto de datos compartido, selecciona un conjunto de datos existente o haz clic en Crear un conjunto de datos para crear uno nuevo. Selecciona el conjunto de datos que deseas publicar en el intercambio de datos. El conjunto de datos debe estar en la misma región que el intercambio de datos. No puedes actualizar este campo después de crear la ficha. El nombre del conjunto de datos de origen y el ID del proyecto que contiene el conjunto de datos se muestran cuando los suscriptores de uso compartido de BigQuery visualizan los metadatos de su conjunto de datos vinculado.

      2. Opcional: Para permitir que los suscriptores compartan un procedimiento almacenado en SQL dentro de una ficha, selecciona Permitir el uso compartido de procedimientos almacenados (Vista previa).

      3. Expande el menú Disponibilidad de datos regionales (Versión preliminar) para que el conjunto de datos compartido esté disponible en regiones adicionales. En el menú, se muestran las regiones en las que existen réplicas del conjunto de datos con la etiqueta Listo para usar. Antes de configurar la ficha para varias regiones, verifica que hayas habilitado la replicación de conjuntos de datos entre regiones en el conjunto de datos compartido, ya que solo puedes seleccionar regiones en las que esté habilitada la replicación de conjuntos de datos entre regiones. Todas las demás regiones se etiquetan como No disponible. Si no se selecciona ninguna región adicional, la ficha usará la región principal del conjunto de datos compartido de forma predeterminada, que se etiqueta como Principal del proveedor.

      4. En Controles de salida de datos, selecciona la opción de salida de datos adecuada.

        • Para aplicar restricciones de salida de datos en tu conjunto de datos compartido, pero no en los resultados de las consultas de tu conjunto de datos compartido, selecciona Inhabilitar la copia y exportación de datos compartidos.
        • Para aplicar restricciones de salida de datos en tu conjunto de datos compartido y en los resultados de las consultas de tu conjunto de datos compartido, selecciona Inhabilitar la copia y exportación de los resultados de las consultas, que también configurará automáticamente la opción Inhabilitar la copia y exportación de datos compartidos.
        • Para aplicar restricciones de copia y exportación de API de datos en tu conjunto de datos compartido, selecciona Inhabilita la copia y exportación de tablas a través de las APIs, que establecerá automáticamente Inhabilita la copia y la exportación de datos compartidos también.

        Para obtener más información sobre los controles de salida de datos, incluidas las restricciones, consulta Opciones de salida de datos (solo para conjuntos de datos compartidos de BigQuery).

    • Si seleccionas Tema de Pub/Sub, en el menú Tema compartido, puedes seleccionar un tema de Pub/Sub existente o hacer clic en Crear un tema para crear uno nuevo.

  5. En la sección Detalles de la ficha, en Nombre visible, ingresa el nombre de la ficha.

  6. Ingresa los siguientes detalles opcionales:

    • Categoría: Selecciona hasta dos categorías que representen de mejor manera tu ficha. Los suscriptores de BigQuery sharing pueden filtrar fichas según estas categorías.

    • Afinidad de datos: Son las regiones que usa el publicador de uso compartido de BigQuery para publicar los datos si usas un tema de Pub/Sub. Esta información es útil para que los suscriptores de uso compartido de BigQuery minimicen o eviten los costos de salida de red de Pub/Sub leyendo los datos desde la misma región. Para obtener más información sobre los costos de salida, consulta Costos de transferencia de datos.

    • Ícono: Un ícono para tu ficha. Se admiten los formatos de archivo PNG y JPEG. Los íconos deben tener un tamaño de archivo de menos de 512 KiB y dimensiones de no más de 512 x 512 píxeles.

    • Descripción: Una descripción breve de tu ficha. Los suscriptores pueden buscar fichas según la descripción.

    • Visibilidad pública: Habilita la visibilidad pública de tu ficha en el catálogo de uso compartido de BigQuery. Si habilitas esta opción, otorga a allUsers o allAuthenticatedUsers el rol Analytics Hub Viewer (roles/analyticshub.viewer). Para obtener más información, consulta Otorga el rol para una ficha. Si el intercambio ya es público, los permisos de la lista ya están heredados y no es necesario realizar ninguna otra acción.

      Los intercambios detectables de forma pública no pueden tener fichas privadas debido a la herencia de permisos, pero los intercambios privados pueden tener fichas públicas. Para que se creen las fichas públicas, el proyecto en el que se encuentra la ficha de datos debe tener una organización y una cuenta de facturación asociadas. Si creas una ficha comercial integrada en Cloud Marketplace, te recomendamos que la hagas visible para el público.

    • Registro de correos electrónicos de los suscriptores: Activa el registro de los identificadores principales de todos los usuarios que ejecutan trabajos y consultas en conjuntos de datos vinculados. Cuando habilitas esta opción, todas las suscripciones futuras para esta ficha tendrán activado el registro de correo electrónico del suscriptor. Los datos registrados están disponibles en el campo job_principal_subject de la vista INFORMATION_SCHEMA.SHARED_DATASET_USAGE.

    • Documentación > Markdown: Información adicional, como vínculos a cualquier documentación relevante y cualquier información adicional que pueda ayudar a los suscriptores del uso compartido de BigQuery a usar tu tema.

  7. En la sección Información de contacto de la ficha, ingresa los siguientes detalles opcionales:

    • Contacto principal: Ingresa un ID de correo electrónico o una URL del contacto principal de la ficha.

    • Solicitar contacto de acceso: Ingresa un ID de correo electrónico o una URL del formulario de admisión para que los suscriptores de uso compartido de BigQuery se comuniquen contigo.

    • Proveedor: Expande la sección Proveedor y especifica los detalles en los siguientes campos:

      • Nombre del proveedor: el nombre del proveedor del tema.
      • Contacto principal del proveedor: Un ID de correo electrónico o una URL del contacto principal del proveedor del tema.

      Los suscriptores pueden filtrar las fichas según los proveedores de datos.

    • Publicador: Expande la sección Publicador y especifica los detalles en los siguientes campos:

      • Nombre del publicador: Es el nombre del publicador de uso compartido de BigQuery que crea la ficha.
      • Contacto principal del publicador: Un ID de correo electrónico o una URL del contacto principal del publicador del tema.

  8. Revisa la sección Vista previa de la ficha.

  9. Haz clic en Publicar.

API

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

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

Reemplaza lo siguiente:

  • PROJECT_ID: el ID del proyecto que contiene el intercambio de datos en el que deseas crear la ficha.
  • LOCATION: la ubicación de tu intercambio de datos. Para obtener más información sobre las ubicaciones que admiten el uso compartido de BigQuery, consulta Regiones admitidas.
  • DATAEXCHANGE_ID: el ID del intercambio de datos.
  • LISTING_ID: el ID de la ficha.

En el cuerpo de la solicitud, proporciona los detalles de la ficha.

Para crear una ficha para varias regiones (versión preliminar), especifica las regiones adicionales en el campo bigqueryDataset.replicaLocations del cuerpo de la solicitud. Antes de configurar la ficha para varias regiones, verifica que hayas habilitado la replicación de conjuntos de datos en varias regiones en el conjunto de datos compartido. Solo puedes seleccionar regiones en las que esté habilitada la replicación de conjuntos de datos entre regiones. Si no se incluye este campo opcional, la ficha se crea con la región principal del conjunto de datos compartido.

Si la solicitud se realiza de forma correcta, el cuerpo de la respuesta contendrá detalles de la ficha. Si habilitas el registro de correos electrónicos de suscriptores con el campo logLinkedDatasetQueryUserEmail, la respuesta de la ficha contendrá log_linked_dataset_query_user_email: true. Los datos registrados están disponibles en el campo job_principal_subject de la vista INFORMATION_SCHEMA.SHARED_DATASET_USAGE.

Para obtener más información sobre las tareas que puedes realizar en las fichas mediante las API, consulta Métodos projects.locations.dataExchanges.listings.

Crea una ficha a partir de un conjunto de datos

También puedes crear una ficha a partir de un conjunto de datos. Para ello, sigue estos pasos:

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

    Ir a BigQuery

  2. Haz clic en un conjunto de datos para ver sus detalles.

  3. Haz clic en Compartir > Publicar como ficha.

    Se abre el cuadro de diálogo Crear ficha.

  4. Selecciona un intercambio de datos en el que deseas publicar esta ficha. El intercambio de datos debe estar en la misma región que el conjunto de datos. Para obtener más información sobre cómo crear un intercambio de datos, consulta Cómo crear un intercambio y establecer permisos.

  5. En el menú Conjunto de datos compartido, selecciona un conjunto de datos existente o haz clic en Crear un conjunto de datos para crear uno nuevo. Selecciona el conjunto de datos que deseas publicar en el intercambio de datos. El conjunto de datos debe estar en la misma región que el intercambio de datos. No puedes actualizar este campo después de crear la ficha.

    El nombre del conjunto de datos de origen y el ID del proyecto que contiene el conjunto de datos se muestran cuando los suscriptores de uso compartido de BigQuery visualizan los metadatos de su conjunto de datos vinculado.

  6. Opcional: Para permitir que los suscriptores compartan un procedimiento almacenado en SQL dentro de una ficha, selecciona Permitir el uso compartido de procedimientos almacenados (Vista previa).

  7. Expande el menú Disponibilidad de datos regionales (Versión preliminar) para que el conjunto de datos compartido esté disponible en regiones adicionales. En el menú, se muestran las regiones en las que existen réplicas del conjunto de datos con la etiqueta Listo para usar. Antes de configurar la ficha para varias regiones, verifica que hayas habilitado la replicación de conjuntos de datos entre regiones en el conjunto de datos compartido, ya que solo puedes seleccionar regiones en las que esté habilitada la replicación de conjuntos de datos entre regiones. Todas las demás regiones se etiquetan como No disponible. Si no se selecciona ninguna región adicional, la ficha usará de forma predeterminada la región del conjunto de datos compartido, que se etiqueta como Principal del proveedor.

  8. En Controles de salida de datos, selecciona la opción de salida de datos adecuada.

    • Para aplicar restricciones de salida de datos en tu conjunto de datos compartido, pero no en los resultados de la consulta de tu conjunto de datos compartido, selecciona Inhabilitar la copia y exportación de datos compartidos.
    • Para aplicar restricciones de salida de datos en tu conjunto de datos compartido y en los resultados de las consultas de tu conjunto de datos compartido, selecciona Inhabilitar la copia y exportación de los resultados de las consultas, que también configurará automáticamente la opción Inhabilitar la copia y exportación de datos compartidos.
    • Para aplicar restricciones de copia y exportación de API de datos en tu conjunto de datos compartidos, selecciona Inhabilita la copia y exportación de tablas a través de las APIs, que establecerá automáticamente Inhabilita la copia y la exportación de datos compartidos también.

    Para obtener más información sobre los controles de salida de datos, incluidas las restricciones, consulta Opciones de salida de datos (solo para conjuntos de datos compartidos de BigQuery).

  9. En la sección Detalles de la ficha, en Nombre visible, ingresa el nombre de la ficha.

  10. Ingresa los siguientes detalles opcionales:

    • Categoría: Selecciona hasta dos categorías que representen de mejor manera tu ficha. Los suscriptores de BigQuery sharing pueden filtrar fichas según estas categorías.

    • Afinidad de datos: Son las regiones que usa el publicador de uso compartido de BigQuery para publicar los datos. Esta información es útil para que los suscriptores de uso compartido de BigQuery minimicen o eviten los costos de salida de red de Pub/Sub leyendo los datos desde la misma región. Para obtener más información sobre los costos de salida, consulta Costos de transferencia de datos.

    • Ícono: Un ícono para tu ficha. Se admiten los formatos de archivo PNG y JPEG. Los íconos deben tener un tamaño de archivo de menos de 512 KiB y dimensiones de no más de 512 x 512 píxeles.

    • Descripción: Una descripción breve de tu ficha. Los suscriptores de BigQuery sharing pueden buscar fichas según la descripción.

    • Visibilidad pública: Habilita la visibilidad pública de tu ficha en el catálogo de uso compartido de BigQuery. Si habilitas esta opción, otorga a allUsers o allAuthenticatedUsers el rol Analytics Hub Viewer (roles/analyticshub.viewer). Para obtener más información, consulta Otorga el rol para una ficha. Si el intercambio ya es público, los permisos de la lista ya están heredados y no es necesario realizar ninguna otra acción.

      Los intercambios detectables de forma pública no pueden tener fichas privadas debido a la herencia de permisos, pero los intercambios privados pueden tener fichas públicas. Para que se creen las fichas públicas, el proyecto en el que se encuentra la ficha de datos debe tener una organización y una cuenta de facturación asociadas. Si creas una ficha comercial integrada en Cloud Marketplace, te recomendamos que la hagas visible para el público.

    • Registro de correos electrónicos de los suscriptores: Activa el registro de los identificadores principales de los suscriptores que ejecutan trabajos y consultas en el conjunto de datos vinculado de esta ficha para todas las suscripciones futuras. Cuando habilitas esta opción, solo las suscripciones creadas recientemente registran los identificadores principales. Los datos registrados están disponibles en el campo job_principal_subject de la vista INFORMATION_SCHEMA.SHARED_DATASET_USAGE.

    • Documentación > Markdown: Información adicional, como vínculos a cualquier documentación relevante y cualquier información adicional que pueda ayudar a los suscriptores a usar tu tema.

  11. En la sección Información de contacto de la ficha, ingresa los siguientes detalles opcionales:

    • Contacto principal: Ingresa un ID de correo electrónico o una URL del contacto principal de la ficha.

    • Solicitar contacto de acceso: Ingresa un ID de correo electrónico o una URL del formulario de admisión para que los suscriptores se comuniquen contigo.

    • Proveedor: Expande la sección Proveedor y especifica los detalles en los siguientes campos:

      • Nombre del proveedor: el nombre del proveedor del tema.
      • Contacto principal del proveedor: Es un ID de correo electrónico o una URL del contacto principal del proveedor del tema.

      Los suscriptores pueden filtrar las fichas según los proveedores de datos.

    • Publicador: Expande la sección Publicador y especifica los detalles en los siguientes campos:

      • Nombre del publicador: Es el nombre del publicador de uso compartido de BigQuery que crea la ficha.
      • Contacto principal del publicador: Un ID de correo electrónico o una URL del contacto principal del publicador del tema.

  12. Revisa la sección Vista previa de la ficha.

  13. Haz clic en Publicar.

Comparte un procedimiento almacenado de SQL en una ficha

Puedes compartir procedimientos almacenados de SQL cuando creas fichas con conjuntos de datos de BigQuery. Dado que los procedimientos almacenados pueden crear, descartar y manipular tablas, así como invocar otros procedimientos almacenados, se necesita autorización adicional.

Autorización de suscriptores

Después de suscribirte a una ficha, es posible que los procedimientos almacenados vinculados no se ejecuten directamente. Para garantizar que se pueda acceder a los procedimientos almacenados vinculados, el suscriptor debe comunicarse con el proveedor con el nombre del conjunto de datos vinculado para que el proveedor autorice el procedimiento almacenado vinculado en los recursos del proveedor. Además, el suscriptor debe autorizar el procedimiento almacenado compartido vinculado y adjuntar un rol de IAM a los recursos que posee para leerlos y escribir en ellos.

Autorización del proveedor

Cuando un proveedor crea una ficha con un procedimiento almacenado, debe permitir que el suscriptor lea y escriba en sus tablas a través del procedimiento almacenado vinculado. Para asegurarte de que sea así, haz lo siguiente:

  • Para las operaciones que no son de lectura, el proveedor debe autorizar el procedimiento almacenado compartido vinculado y vincular un rol de IAM a cualquiera de los recursos del proveedor a los que acceda el procedimiento almacenado vinculado.

  • Para las operaciones de lectura, el proveedor puede autorizar el procedimiento almacenado compartido vinculado (en el conjunto de datos vinculado del suscriptor) o su procedimiento almacenado compartido original (en el conjunto de datos del proveedor) y vincular un rol de IAM a cualquiera de los recursos del proveedor a los que acceda el procedimiento almacenado vinculado.

Otorga a los usuarios acceso a una ficha

Si deseas otorgar a los usuarios acceso a una ficha privada, debes configurar una política de IAM para una persona o un grupo para esa ficha. Para una ficha comercial, tu intercambio de datos debe ser público. Las fichas de un intercambio de datos públicos aparecen en BigQuery sharing para todos los Google Cloud usuarios (allAuthenticatedUsers). Para permitir que los usuarios exploren las fichas comerciales y soliciten acceso a ellas, debes otorgarles el rol de visualizador de Analytics Hub (roles/analyticshub.viewer). Para permitir que los usuarios se suscriban a las fichas comerciales, debes otorgarles explícitamente el rol de suscriptor de Analytics Hub (roles/analyticshub.subscriber). En el caso de las fichas comerciales integradas en Cloud Marketplace, el rol de suscriptor de Analytics Hub se aprovisiona automáticamente según los pedidos de Cloud Marketplace.

Si deseas que todos los usuarios puedan acceder a tu ficha, incluidas las personas que no usan Google Cloud, debes otorgar a allUsers el rol de visualizador de Analytics Hub (roles/analyticshub.viewer).

A fin de otorgar a los usuarios acceso para ver tu ficha o suscribirse a ella, sigue estos pasos:

Console

  1. Ve a la página Uso compartido (Analytics Hub).

    Ir a Uso compartido (Analytics Hub)

  2. Haz clic en el nombre del intercambio de datos que contiene la ficha.

  3. Haz clic en la ficha a la que deseas agregar suscriptores.

  4. Haz clic en Establecer permisos.

  5. Para agregar principales, haz clic en Agregar principal.

  6. En el campo Principales nuevos, agrega los siguientes detalles según el tipo de ficha:

    • Para una ficha privada, ingresa los IDs de correo electrónico de la identidad a la que deseas otorgar acceso.

    • Para una ficha pública, agrega allAuthenticatedUsers.

    • Para una ficha pública que sea detectable para todos, incluidos los usuarios que no son deGoogle Cloud, agrega allUsers.

  7. En Selecciona un rol, mantén el puntero sobre Analytics Hub y, luego, según el tipo de ficha, selecciona uno de los siguientes roles:

    • Para una ficha comercial (incluidas las fichas integradas en Cloud Marketplace), selecciona el rol Visualizador de Analytics Hub. Este rol permite a los usuarios ver la ficha y solicitar acceso.

    • Para una ficha pública privada o no comercial, selecciona el rol de suscriptor de Analytics Hub. Este rol permite que los usuarios se suscriban a tu ficha.

    • En el caso de las fichas integradas en Cloud Marketplace, no es necesario otorgar el rol Analytics Hub Subscriber (roles/analyticshub.subscriber), ya que las suscripciones se rigen y administran automáticamente según el pedido de Cloud Marketplace.

    Para obtener más información, consulta los roles de suscriptor y visualizador de Analytics Hub.

  8. Haz clic en Guardar.

API

  1. Lee la política existente con el método getIamPolicy de la lista a través del método projects.locations.dataExchanges.listings.getIamPolicy.

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

    Reemplaza lo siguiente:

    • PROJECT_ID: es el ID del proyecto, por ejemplo, my-project-1.
    • LOCATION: la ubicación del intercambio de datos que contiene la ficha.
    • DATAEXCHANGE_ID: el ID del intercambio de datos.
    • LISTING_ID: el ID de la ficha.

    El uso compartido muestra la política actual en la respuesta.

  2. Para agregar o quitar miembros y sus funciones asociadas, edita la política con un editor de texto. Usa el siguiente formato para agregar miembros:

    • user:test-user@gmail.com
    • group:admins@example.com
    • serviceAccount:test123@example.domain.com
    • domain:example.domain.com

    Por ejemplo, para otorgar la función roles/analyticshub.subscriber a group:subscribers@example.com, agrega la siguiente vinculación a la política:

    {
 "members": [
   "group:subscribers@example.com"
 ],
 "role":"roles/analyticshub.subscriber"
}

  3. Escribe la política actualizada mediante el método projects.locations.dataExchanges.listings.setIamPolicy. En el cuerpo de la solicitud, proporciona la política de IAM actualizada del paso anterior.

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

    En el cuerpo de la solicitud, proporciona los detalles de la ficha. Si la solicitud se realiza de forma correcta, el cuerpo de la respuesta contendrá detalles de la ficha.

Para obtener más información sobre las tareas que puedes realizar en las fichas mediante las API, consulta Métodos projects.locations.dataExchanges.listings.

Crea una URL no autenticada para la ficha pública

Para crear una URL de ficha de uso compartido de BigQuery no autenticada que sea visible incluso para usuarios que no son deGoogle Cloud , haz lo siguiente:

  1. Ve a la página Uso compartido (Analytics Hub).

    Ir a Uso compartido (Analytics Hub)

    Aparecerá una página que enumera todos los intercambios de datos a los que puedes acceder.

  2. Haz clic en el nombre del intercambio de datos que contiene la ficha.

  3. Haz clic en el nombre visible para ver los detalles de la ficha. La ficha debe tener habilitada la visibilidad pública.

  4. Haz clic en Copiar vínculo público para generar una URL de ficha no autenticada. Asegúrate de que esta ficha otorgue a allUsers el rol Analytics Hub Viewer (roles/analyticshub.viewer).

Crea un administrador de fichas

Para permitir que los usuarios administren fichas, debes crear administradores de fichas. Para crear administradores de fichas, debes otorgar a los usuarios el rol de IAM de publicador de Analytics Hub o administrador de fichas de Analytics Hub a nivel de la ficha. Si deseas obtener más información para otorgar estos roles para una ficha, consulta Otorga el rol para una ficha.

Visualiza todas las suscripciones

Para ver todas las suscripciones actuales a tu ficha, selecciona una de las siguientes opciones:

Console

  1. Ve a la página Uso compartido (Analytics Hub).

    Ir a Uso compartido (Analytics Hub)

  2. Haz clic en el nombre del intercambio de datos que contiene la ficha para la que deseas administrar las suscripciones.

  3. Haz clic en la ficha para la que deseas enumerar todos los suscriptores.

  4. Para ver todos los suscriptores de tu ficha, haz clic en Administrar suscripciones.

    administrar suscriptores

  5. Opcional: Puedes filtrar los resultados por detalles del suscriptor.

De forma alternativa, si tienes acceso al conjunto de datos compartido, puedes seguir estos pasos para enumerar los suscriptores:

  1. Ve a la página de BigQuery.

    Ir a BigQuery

  2. En el panel de la izquierda, haz clic en Explorar:

    Botón destacado del panel Explorador.

    Si no ves el panel izquierdo, haz clic en Expandir panel izquierdo para abrirlo.

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

  4. En la lista Uso compartido, selecciona Administrar suscripciones.

SQL

En el siguiente ejemplo, se usa la vista INFORMATION_SCHEMA.SCHEMATA_LINKS para enumerar todos los conjuntos de datos vinculados a un conjunto de datos compartido en myproject que se encuentran en la región us:

SELECT * FROM `myproject`.`region-us`.INFORMATION_SCHEMA.SCHEMATA_LINKS;

El resultado es similar al siguiente. Algunas columnas se omiten para simplificar el resultado.

+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
|  catalog_name  | schema_name | linked_schema_catalog_name | linked_schema_catalog_number | linked_schema_name | linked_schema_org_display_name |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
| myproject      | myschema1   | subscriptionproject1       |                 974999999291 | subscriptionld1    | subscriptionorg                |
| myproject      | myschema2   | subscriptionproject2       |                 974999999292 | subscriptionld2    | subscriptionorg                |
| myproject      | myschema3   | subscriptionproject3       |                 974999999293 | subscriptionld3    | subscriptionorg                |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+

En el caso de una ficha con varias regiones (Vista previa), puedes ver las suscripciones en diferentes regiones reemplazando la región us por la ubicación de réplica deseada. Por ejemplo, para ver los conjuntos de datos vinculados a un conjunto de datos compartido en myproject que se encuentran en la región eu, usa la siguiente consulta:

SELECT * FROM `myproject`.`region-eu`.INFORMATION_SCHEMA.SCHEMATA_LINKS;

API

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

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

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 que contiene la ficha a la que deseas suscribirte.
  • LISTING_ID: el ID de la ficha a la que deseas suscribirte.

Quita una suscripción

Cuando quitas una suscripción creada antes del 25 de julio de 2023 de tus fichas, el conjunto de datos vinculado se desvincula del conjunto de datos compartido. Los suscriptores aún pueden ver los conjuntos de datos en sus proyectos, pero ya no están vinculados con el conjunto de datos compartido.

Para quitar una suscripción creada antes del 25 de julio de 2023 de tus fichas, sigue estos pasos:

  1. Para enumerar todos los suscriptores de una ficha, sigue las instrucciones de la consola de Google Cloud en Visualiza todas las suscripciones.

  2. Para quitar un suscriptor de una ficha, haz clic en Borrar. Si deseas quitar todas las suscripciones, haz clic en Quitar todas las suscripciones.

  3. En el cuadro de diálogo ¿Deseas quitar la suscripción?, ingresa remove para confirmar.

  4. Haz clic en Quitar.

Para quitar las suscripciones creadas después del 25 de julio de 2023, sigue estos pasos:

Console

  1. Para enumerar todos los suscriptores de una ficha, sigue las instrucciones de la consola de Google Cloud en Visualiza todas las suscripciones.

  2. Haz clic en la pestaña Suscripciones.

  3. Para quitar un suscriptor de una ficha, selecciona las suscripciones que deseas quitar y haz clic en Quitar suscripciones.

  4. En el cuadro de diálogo ¿Deseas quitar la suscripción?, ingresa remove para confirmar.

  5. Haz clic en Quitar.

API

Usa el método projects.locations.subscriptions.revoke (vista previa).

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/subscriptions/SUBSCRIPTION_ID:revoke

Reemplaza lo siguiente:

  • PROJECT_ID: el ID del proyecto de la suscripción que deseas quitar.
  • LOCATION: la ubicación de la suscripción que deseas quitar.
  • SUBSCRIPTION: el ID de la suscripción que deseas quitar.

Actualiza una ficha

Para actualizar una ficha, sigue estos pasos:

Console

  1. Ve a la página Uso compartido (Analytics Hub).

    Ir a Uso compartido (Analytics Hub)

  2. Haz clic en el nombre del intercambio de datos que contiene la ficha.

  3. Haz clic en la ficha que deseas actualizar.

  4. Haz clic en Editar ficha.

  5. Modifica los valores en los campos. Puedes modificar todos los valores, excepto el conjunto de datos compartido de la ficha.

  6. Opcional:

    • Si habilitas la visibilidad pública, otorga el rol Analytics Hub Viewer (roles/analyticshub.viewer) a allUsers o allAuthenticatedUsers. Para obtener más información, consulta Otorga el rol para una ficha.
    • Si inhabilitas la visibilidad pública, quita el rol Analytics Hub Viewer (roles/analyticshub.viewer) de allUsers y allAuthenticatedUsers. Los intercambios públicos no pueden tener fichas privadas, pero los intercambios privados pueden tener fichas públicas.
    • Si habilitas y guardas el registro de los correos electrónicos de los suscriptores, no se podrá editar este parámetro de configuración. Para inhabilitar el registro de correos electrónicos, borra la ficha y vuelve a crearla sin hacer clic en el botón de activación Registro de correos electrónicos de suscriptores.
    • Agrega o quita regiones de la ficha (Vista previa). Antes de agregar varias regiones, verifica que hayas habilitado la replicación de conjuntos de datos entre regiones en el conjunto de datos compartido. Cuando quites regiones, primero borra la réplica del conjunto de datos compartido en esa región.

  7. Obtén una vista previa de la ficha.

  8. Para guardar los cambios, haz clic en Guardar. Para evitar discrepancias con las fichas integradas en Cloud Marketplace, aparece una notificación que solicita una actualización de la ficha del producto de datos de Cloud Marketplace.

API

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

PATCH https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID?updateMask=UPDATEMASK

Reemplaza UPDATEMASK por la lista de campos que deseas actualizar. Si deseas actualizar varios valores, usa una lista separada por comas. Por ejemplo, para actualizar el nombre visible y el contacto principal de un intercambio de datos, ingresa displayName,primaryContact.

En el cuerpo de la solicitud, especifica los valores actualizados para los siguientes campos:

  • displayName
  • description
  • primaryContact
  • documentation
  • icon
  • categories[]
  • discoveryType
  • logLinkedDatasetQueryUserEmail

Para obtener detalles sobre estos campos, consulta Recurso: Listing.

Cuando actualices las regiones de réplica de tu ficha, asegúrate de especificar todas las regiones aplicables. Antes de actualizar la ficha, verifica que hayas habilitado la replicación de conjuntos de datos entre regiones en el conjunto de datos compartido. Solo puedes agregar regiones (Vista previa) en las que se replica el conjunto de datos compartido. Para quitar una región, borra la réplica del conjunto de datos compartido de la región antes de quitarla de la ficha. Solo puedes actualizar las regiones de las réplicas para las fichas creadas recientemente en varias regiones. No puedes convertir fichas existentes en fichas para varias regiones.

Para obtener más información sobre las tareas que puedes realizar en las fichas mediante las API, consulta Métodos projects.locations.dataExchanges.listings.

Borra una ficha

Cuando borras una ficha, los suscriptores ya no pueden verla. Si borras una ficha, también se borran todos los conjuntos de datos vinculados y se quitan todas las suscripciones de los proyectos de los suscriptores. Si un conjunto de datos permanece vinculado, haz clic en Uso compartido > Administrar suscripción para quitarlo de forma manual. Se abrirá la página Suscripciones, en la que puedes quitar un conjunto de datos de un suscriptor específico o todos los conjuntos de datos de suscriptores a la vez.

No puedes borrar las fichas integradas en Cloud Marketplace con suscripciones comerciales activas. Revoca todas las suscripciones comerciales antes de borrar la ficha.

Borrar una ficha para varias regiones (Vista previa) no borra las réplicas de conjuntos de datos compartidos. Después de borrar la ficha para varias regiones, los suscriptores ya no podrán verla ni consultar los conjuntos de datos vinculados. Si las réplicas del conjunto de datos compartido no se referencian en otras fichas, puedes borrarlas.

Antes de borrar una ficha para varias regiones (Vista previa), asegúrate de que no haya suscripciones activas asociadas a ella. Si existen suscripciones activas, primero debes revocarlas con el método projects.locations.subscriptions.revoke. Una vez que se quiten todas las suscripciones activas, podrás borrar la ficha para varias regiones.

Para borrar una ficha, sigue estos pasos:

Console

  1. Ve a la página Uso compartido (Analytics Hub).

    Ir a Uso compartido (Analytics Hub)

  2. Haz clic en el nombre del intercambio de datos que contiene la ficha.

  3. Haz clic en la ficha que deseas borrar.

  4. Haz clic en Borrar.

  5. En el cuadro de diálogo ¿Borrar ficha?, escribe borrar para confirmar la eliminación.

  6. Haz clic en Borrar.

API

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

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

Para obtener más información sobre las tareas que puedes realizar en las fichas mediante las API, consulta Métodos projects.locations.dataExchanges.listings.

Para aumentar la visibilidad y el reconocimiento de tu ficha en el catálogo de uso compartido de BigQuery, las fichas se pueden mostrar en la sección Destacadas. Las fichas destacadas se rigen por el Google Cloud Acuerdo de Partner Advantage.

Los socios interesados en que sus fichas estén en la sección Destacadas del catálogo de BigQuery sharing deben cumplir con los siguientes criterios:

Para solicitar que tu ficha aparezca en la sección Destacadas, completa y envía el formulario de admisión. Para solicitar que se quite tu ficha de la sección, envía el mismo formulario de admisión.

¿Qué sigue?