Administra conjuntos de contexto en Spanner Studio

En este documento, se describe cómo crear conjuntos de contexto en Spanner Studio con un archivo de conjunto de contexto. Cuando creas un conjunto de contexto en Spanner Studio, este lo almacena en el grupo de conjuntos de contexto default del proyecto para la región seleccionada y lo vincula a la base de datos actual. Los nombres de los conjuntos de contextos (y sus IDs de conjuntos de contextos derivados) deben ser únicos dentro del grupo de conjuntos de contextos default del proyecto para una región determinada, en todas las bases de datos y las instancias. En Spanner Studio, la creación de un conjunto de contextos con un nombre cuyo ID derivado ya existe no pasa la validación. Para reemplazar su contenido y mantener sus asociaciones de bases de datos, edita el conjunto de contextos existente. Si subes contenido directamente a través del agente de ingeniería de contexto o la API de Dataplex con un ID de conjunto de contexto existente, se reemplazará su contenido y, si se especifican, sus asociaciones de bases de datos.

La lista Conjuntos de contexto de Spanner Studio solo muestra los conjuntos de contexto del grupo de conjuntos de contexto default en todas las regiones admitidas que están vinculadas a la base de datos actual. Los conjuntos de contexto creados para otra base de datos o creados a través de la API sin vincular el recurso de la base de datos en databases (o en un grupo de conjuntos de contexto personalizado) no aparecen en la lista de Spanner Studio.

Para obtener más información sobre los conjuntos de contexto, consulta Descripción general de los conjuntos de contexto.

Antes de comenzar

Completa los siguientes requisitos previos antes de crear o subir un conjunto de contexto.

Habilita los servicios obligatorios

Habilita los siguientes servicios para tu proyecto:

Prepara una instancia de Spanner

Roles y permisos requeridos

  • Agrega un usuario o una cuenta de servicio de IAM a la instancia. Para obtener más información, consulta Aplica roles de IAM.
  • Otorga los roles roles/spanner.databaseReader, roles/serviceusage.serviceUsageConsumer y roles/geminidataanalytics.queryDataUser al usuario de IAM a nivel del proyecto. Para obtener más información, consulta Agrega una vinculación de política de IAM para un proyecto.
  • Para crear, subir y administrar conjuntos de contexto, otorga el rol de editor de Dataplex Catalog (roles/dataplex.catalogEditor) o de administrador de Dataplex Catalog (roles/dataplex.catalogAdmin) al usuario de IAM a nivel del proyecto. Para obtener más información, consulta El contexto establece permisos.
  • Otorga roles y permisos al usuario de IAM a nivel de proyecto para las bases de datos requeridas.

Crear un conjunto de contextos

Para crear un conjunto de contexto, sigue estos pasos:

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

    Ir a Spanner

  2. Selecciona una instancia de la lista y, luego, una base de datos.

  3. En el menú de navegación, haz clic en Spanner Studio.

  4. En el panel Explorador, junto a Conjuntos de contexto, haz clic en Ver acciones.

  5. Haz clic en Crear conjunto de contextos.

  6. En Nombre del conjunto de contextos, proporciona un nombre único para el conjunto de contextos. En Spanner Studio, el nombre debe tener entre 4 y 30 caracteres, y no puede comenzar con un espacio en blanco. Studio deriva el ID del conjunto de contexto convirtiendo el nombre a minúsculas y reemplazando los caracteres no alfanuméricos por guiones (-). El ID del conjunto de contexto derivado debe ser único dentro del grupo de conjuntos de contexto default del proyecto para la región seleccionada. Por ejemplo, el nombre del conjunto de contextos querydata_e2e_test tiene el ID de conjunto de contextos querydata-e2e-test. Cuando subes un conjunto de contexto directamente con el agente de ingeniería de contexto o la API de Dataplex, el ID del conjunto de contexto distingue mayúsculas de minúsculas, no puede contener barras diagonales (/) y no está restringido a entre 4 y 30 caracteres, ni a caracteres alfanuméricos, guiones y guiones bajos.

  7. Es opcional. En Descripción del conjunto de contextos, agrega una descripción para tu conjunto de contextos.

  8. Es opcional. Para subir un archivo de conjunto de contexto, haz clic en Explorar en la sección Subir archivo de conjunto de contexto y selecciona el archivo de conjunto de contexto.

  9. Es opcional. Para elegir una región para el conjunto de contexto, haz clic en Mostrar opciones avanzadas y selecciona una región en Seleccionar una ubicación (el valor predeterminado es us-east1 en cada creación). Si eliges una región que no sea us-east1, selecciónala antes de ingresar el nombre del conjunto de contexto para que Spanner Studio valide la exclusividad del nombre en esa región.

  10. Haz clic en Crear.

Crea conjuntos de información contextual

Después de crear un conjunto de información contextual, sigue los pasos que se indican en Crea conjuntos de información contextual con el agente de ingeniería de contexto para crear un archivo de conjunto de información contextual. Luego, puedes editar tu conjunto de contexto para subir el archivo correspondiente.

Cómo editar un conjunto de contextos

Para editar un conjunto de contextos, sigue estos pasos:

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

    Ir a Spanner

  2. Selecciona una instancia de la lista y, luego, una base de datos.

  3. En el menú de navegación, haz clic en Spanner Studio.

  4. Haz clic en Ver acciones junto al conjunto de contextos que deseas editar.

  5. Haz clic en Editar conjunto de contextos.

  6. Es opcional. Edita la descripción del conjunto de información contextual.

  7. Haz clic en Explorar en la sección Subir archivo de conjunto de contextos y selecciona el archivo de conjunto de contextos.

  8. Haz clic en Guardar.

Borra un conjunto de información contextual

Para borrar un conjunto de contextos, sigue estos pasos:

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

    Ir a Spanner

  2. Selecciona una instancia de la lista y, luego, una base de datos.

  3. En el menú de navegación, haz clic en Spanner Studio.

  4. Haz clic en Ver acciones junto al conjunto de contextos que quieres borrar.

  5. Haz clic en Borrar conjunto de contextos.

  6. En el cuadro de diálogo de confirmación Borrar conjunto de contextos, ingresa el ID del conjunto de contextos.

  7. Haz clic en Confirmar para borrar el conjunto de contextos.

¿Qué sigue?