Gestionar fichas

Consola

Ve a la página de la API Analytics Hub y habilítala en tu proyecto. Google Cloud

Habilitar la API Analytics Hub

gcloud

Ejecuta el comando gcloud services enable:

gcloud services enable analyticshub.googleapis.com

Consola

1. Vaya a la página Compartir (Analytics Hub).

   Ir a Compartir (Analytics Hub)

   Aparecerá una página con todos los intercambios de datos a los que tienes acceso.

2. Haga clic en el nombre del intercambio de datos en el que quiera crear la ficha.

3. Haz clic en add_box 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 selecciona Conjunto de datos de BigQuery, haga lo siguiente:

     1. En el menú Conjunto de datos compartido, seleccione un conjunto de datos o haga clic en Crear conjunto de datos para crear uno. Selecciona el conjunto de datos que quieras incluir 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 devuelven cuando los suscriptores ven los metadatos de su conjunto de datos vinculado.

     2. Despliega el menú Disponibilidad de datos por región (Vista previa) para que el conjunto de datos compartido esté disponible en otras regiones. En el menú se muestran las regiones en las que hay réplicas de conjuntos de datos con la etiqueta Listo para usar. Antes de configurar la ficha en varias regiones, comprueba que has habilitado la réplica de conjuntos de datos entre regiones en el conjunto de datos compartido, ya que solo puedes seleccionar regiones en las que esté habilitada esta opción. El resto de las regiones se etiquetan como No disponible. Si no se selecciona ninguna región adicional, la ficha usará de forma predeterminada la región principal del conjunto de datos compartido, que se etiqueta como Principal del proveedor.

     3. 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 la 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 la exportación de resultados de consultas, lo que también activará automáticamente la opción Inhabilitar la copia y la exportación de datos compartidos.
        • Para aplicar restricciones de copia y exportación de datos de la API Data a tu conjunto de datos compartido, selecciona Inhabilitar la copia y la exportación de tablas a través de APIs, lo que también activará automáticamente la opción Inhabilitar la copia y la exportación de datos compartidos.

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

5. En la sección Tu ficha, en Nombre visible, escribe el nombre de la ficha.

6. Introduce los siguientes detalles opcionales:

   • Categoría: selecciona hasta dos categorías que representen mejor tu ficha. Los suscriptores pueden filtrar las fichas según estas categorías.

   • Afinidad de datos: regiones que usa el editor para publicar los datos si utilizas un tema de Pub/Sub. Esta información es útil para que los suscriptores minimicen o eviten los costes de salida de red de Pub/Sub leyendo los datos de la misma región. Para obtener más información sobre los costes de salida, consulta los costes de transferencia de datos.

   • Icono: un icono para tu ficha. Se admiten los formatos de archivo PNG y JPEG. Los iconos deben tener un tamaño de archivo inferior a 512 KiB y unas dimensiones máximas de 512 x 512 píxeles.

   • Descripción: una breve descripción 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 habilita esta opción, conceda el rol de lector de Analytics Hub a allUsers o allAuthenticatedUsers (roles/analyticshub.viewer). Para obtener más información, consulte Conceder el rol a una ficha. Si la exchange ya es pública, los permisos de publicación ya se habrán heredado y no será necesario hacer nada más.

     Los exchanges detectables públicamente no pueden tener fichas privadas debido a la herencia de permisos, pero los exchanges privados sí pueden tener fichas públicas. Para que se puedan crear fichas públicas, el proyecto en el que se encuentre la ficha de datos debe tener una organización y una cuenta de facturación asociadas. Si vas a crear una ficha comercial integrada en Cloud Marketplace, te recomendamos que hagas que se pueda descubrir públicamente.

   • Documentación > Markdown: información adicional, como enlaces a documentación pertinente y cualquier otra información que pueda ayudar a los suscriptores a usar tu tema.

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

   • Contacto principal: introduce un ID de correo o una URL del contacto principal de la ficha.

   • Contacto para solicitar acceso: introduce un ID de correo o una URL del formulario de solicitud para que los suscriptores se pongan en contacto contigo.

   • Proveedor: amplíe la sección Proveedor y especifique los detalles en los siguientes campos:

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

     Los suscriptores pueden filtrar las fichas en función de los proveedores de datos.

   • Editor: despliega la sección Editor y especifica los detalles en los siguientes campos:

     • Nombre del editor: el nombre del editor que crea la ficha.
     • Contacto principal del editor: un ID de correo o una URL del contacto principal del editor del tema.

8. Consulte 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

Haz los cambios siguientes:

• PROJECT_ID: el ID del proyecto que contiene el intercambio de datos en el que quiere crear la ficha.
• LOCATION: la ubicación de su intercambio de datos. Para obtener más información sobre las ubicaciones que admiten el uso compartido de BigQuery, consulta las regiones admitidas.
• DATAEXCHANGE_ID: el ID de 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 en varias regiones (vista previa), especifica las regiones adicionales en el campo bigqueryDataset.replicaLocations del cuerpo de la solicitud. Antes de configurar la ficha para varias regiones, comprueba que has habilitado la réplica de conjuntos de datos entre 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 correctamente, el cuerpo de la respuesta contiene los detalles de la ficha. Si habilitas el registro de correos de suscriptores (vista previa), la respuesta de la ficha contendrá log_linked_dataset_query_user_email: true.

Para obtener más información sobre las tareas que puede realizar en las fichas mediante APIs, consulte los métodos de projects.locations.dataExchanges.listings.

Consola

1. Vaya a la página Compartir (Analytics Hub).

   Ir a Compartir (Analytics Hub)

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

3. Haz clic en la ficha a la que quieras añadir suscriptores.

4. Haz clic en person Establecer permisos.

5. Para añadir principales, haz clic en person_add Añadir principal.

6. En el campo Nuevos principales, añade los siguientes detalles en función del tipo de ficha:

   • En el caso de una ficha privada, introduce los IDs de correo de la identidad a la que quieras dar acceso.

   • Para una ficha pública, añade allAuthenticatedUsers.

   • Para que una ficha pública sea visible para todos los usuarios, incluidos los que no tengan una cuenta deGoogle Cloud, añade allUsers.

7. En Selecciona un rol, coloca el puntero sobre Centro de análisis y, a continuación, en función del tipo de ficha, selecciona uno de los siguientes roles:

   • En el caso de las fichas comerciales (incluidas las fichas integradas en Cloud Marketplace), selecciona el rol Lector del centro de analíticas. Este rol permite a los usuarios ver la ficha y solicitar acceso.

   • En el caso de las fichas públicas privadas o no comerciales, selecciona el rol Suscriptor de Centro de análisis. Este rol permite a los usuarios suscribirse a tu ficha.

   • En el caso de las fichas integradas en Cloud Marketplace, no es necesario conceder el rol de suscriptor del centro de analíticas, ya que las suscripciones se rigen y gestionan automáticamente en función del pedido de Cloud Marketplace.

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

8. Haz clic en Guardar.

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

9. Haz clic en Guardar.

API

1. Lee la política actual con el método getIamPolicy de la ficha mediante el 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
   

   Haz los cambios siguientes:

   • PROJECT_ID: 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 de intercambio de datos.
   • LISTING_ID: el ID de la ficha.

   Al compartir, se devuelve la política actual en la respuesta.

2. Para añadir o quitar miembros y sus roles asociados, edita la política con un editor de texto. Utiliza el siguiente formato para añadir miembros:

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

   Por ejemplo, para asignar el rol roles/analyticshub.subscriber a group:subscribers@example.com, añade la siguiente vinculación a la política:

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

3. Escribe la política actualizada con el método projects.locations.dataExchanges.listings.setIamPolicy. En el cuerpo de la solicitud, proporciona la política de gestión de identidades y accesos 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 correctamente, el cuerpo de la respuesta contiene los detalles de la ficha.

Para obtener más información sobre las tareas que puede realizar en las fichas mediante APIs, consulte los métodos de projects.locations.dataExchanges.listings.

Consola

1. Vaya a la página Compartir (Analytics Hub).

   Ir a Compartir (Analytics Hub)

2. Haga clic en el nombre del intercambio de datos que contenga la ficha de la que quiera gestionar las suscripciones.

3. Haz clic en la ficha de la que quieras obtener una lista de todos los suscriptores.

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

   

5. Opcional: Puedes filtrar los resultados por detalles de los suscriptores.

Si tienes acceso al conjunto de datos compartido, puedes seguir estos pasos para ver la lista de suscriptores:

1. Ve a la página BigQuery.

   Ir a BigQuery

2. En el panel Explorador, expande tu proyecto y selecciona el conjunto de datos compartido.

3. En la lista person_add Compartir, selecciona Gestionar 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;

La salida es similar a la siguiente. Se han omitido algunas columnas 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 de las distintas regiones sustituyendo la región us por la ubicación de réplica que quieras. Por ejemplo, para ver los conjuntos de datos vinculados a un conjunto de datos compartido en myproject que se encuentren 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

Haz los cambios siguientes:

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

Consola

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

2. Haz clic en la pestaña Suscripciones.

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

4. En el cuadro de diálogo ¿Quitar suscripción?, introduce remove para confirmar.

5. Haz clic en Quitar.

API

Usa el método projects.locations.subscriptions.revoke.

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

Haz los cambios siguientes:

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

Consola

1. Vaya a la página Compartir (Analytics Hub).

   Ir a Compartir (Analytics Hub)

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

3. Haz clic en la ficha que quieras actualizar.

4. Haz clic en mode_edit Editar ficha.

5. Modifica los valores de los campos. Puede modificar todos los valores, excepto el conjunto de datos de origen de la ficha.

6. Optional:

   • Si habilita la visibilidad pública, conceda el rol de lector de Analytics Hub (roles/analyticshub.viewer) a allUsers o allAuthenticatedUsers. Para obtener más información, consulte Conceder el rol a una ficha.
   • Si inhabilita la visibilidad pública, quite el rol de lector de Analytics Hub de allUsers y allAuthenticatedUsers. Los mercados públicos no pueden tener fichas privadas, pero los mercados privados sí pueden tener fichas públicas.
   • Si habilitas y guardas el registro de correos de suscriptores, este ajuste no se podrá editar. Para inhabilitar el registro de correos, elimina la ficha y vuelve a crearla sin hacer clic en el interruptor Registro de correos de suscriptores (Vista previa).
   • Añade o quita regiones de la ficha (Vista previa). Antes de añadir varias regiones, comprueba que has habilitado la réplica de conjuntos de datos entre regiones en el conjunto de datos compartido. Cuando elimine regiones, primero elimine la réplica del conjunto de datos compartido de esa región.

7. Previsualiza 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 que se actualice la ficha de 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

Sustituye UPDATEMASK por la lista de campos que quieras actualizar. Para actualizar varios valores, utilice una lista separada por comas. En el cuerpo de la solicitud, especifica los valores actualizados.

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

• Nombre visible
• Descripción
• Categorías
• Documentación
• Icono
• Contacto principal
• Descubribilidad pública
• Registro de correos de suscriptores (vista previa)

Para obtener información sobre estos campos, consulta Recurso: Listing.

Cuando actualice las regiones de réplica de su ficha, asegúrese de especificar todas las regiones aplicables. Antes de actualizar la ficha, comprueba que has habilitado la réplica de conjuntos de datos entre regiones en el conjunto de datos compartido. Solo puede añadir regiones (Vista previa) en las que se replique el conjunto de datos compartido. Para quitar una región, elimina la réplica del conjunto de datos compartido de la región antes de quitarla de la lista. Solo puedes actualizar las regiones de réplica de las fichas que se hayan creado recientemente para varias regiones. No puedes convertir fichas que ya tengas en fichas para varias regiones.

Para obtener más información sobre las tareas que puede realizar en las fichas mediante APIs, consulte los métodos de projects.locations.dataExchanges.listings.

Consola

1. Vaya a la página Compartir (Analytics Hub).

   Ir a Compartir (Analytics Hub)

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

3. Haz clic en la ficha que quieras eliminar.

4. Haz clic en delete Eliminar.

5. En el cuadro de diálogo ¿Eliminar ficha?, confirma la eliminación escribiendo eliminar.

6. Haz clic en Eliminar.

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 puede realizar en las fichas mediante APIs, consulte los métodos de projects.locations.dataExchanges.listings.