En esta página, se describe cómo crear y administrar Spanner particiones.
Antes de comenzar
Para usar particiones, debes configurar la base de datos opt_in_dataplacement_preview
en tu base de datos vacía:
Console
Ve a la página Instancias en la consola de Google Cloud.
Selecciona la instancia en la que deseas agregar las particiones.
Selecciona la base de datos vacía en la que deseas particionar los datos.
En el menú de navegación, haz clic en Spanner Studio.
En la página Spanner Studio, haz clic en
Nueva pestaña o usa la pestaña del editor vacía.Ingresa la siguiente declaración DDL
ALTER DATABASE
.ALTER DATABASE DATABASE_ID SET OPTIONS (opt_in_dataplacement_preview = true);
Reemplaza DATABASE_ID por el identificador único de tu en la base de datos.
Haz clic en Ejecutar.
gcloud
Para configurar la opción de base de datos opt_in_dataplacement_preview
, usa
gcloud spanner databases ddl update
gcloud spanner databases ddl update DATABASE_ID \
--instance=INSTANCE_ID \
--ddl="ALTER DATABASE db SET OPTIONS (opt_in_dataplacement_preview = true);"
Reemplaza lo siguiente:
DATABASE_ID
: Es el identificador permanente de tu Spanner. en la base de datos.INSTANCE_ID
: Es el identificador permanente de tu Spanner. instancia.
Crea una partición
Console
En la consola de Google Cloud, abre la página de Spanner.
Selecciona la instancia en la que deseas agregar las particiones.
En el menú de navegación, selecciona Particiones.
Haz clic en Crear partición.
Ingresa un ID de partición para identificar tu partición de forma permanente. El El ID de partición también debe ser único en tu proyecto de Google Cloud. No podrás cambiar el ID de la partición más adelante.
En la sección Elige una configuración, selecciona Regional. o multirregional. Como alternativa, si deseas comparar las especificaciones regiones y, luego, haz clic en Comparar configuraciones regionales.
Selecciona una configuración en el menú desplegable.
En la sección Asignar capacidad de procesamiento, en Unidad, haz lo siguiente: haz clic en una de las siguientes opciones:
- Unidades de procesamiento para particiones de instancias pequeñas.
- Nodos para instancias grandes. Un nodo consta de 1,000 unidades de procesamiento.
Ingresa un valor para la unidad seleccionada.
Tu partición debe tener al menos un nodo o 1,000 unidades de procesamiento.
Haz clic en Crear para crear la partición.
gcloud
Para crear una partición, usa gcloud beta spanner instance-partitions create
.
gcloud beta spanner instance-partitions create PARTITION_ID \ --config=PARTITION_CONFIG \ --description="PARTITION_DESCRIPTION" \ --instance=INSTANCE_ID \ [--nodes=NODE_COUNT | --processing-units=PROCESSING_UNIT_COUNT]
Reemplaza lo siguiente:
- PARTITION_ID: Es el identificador de partición permanente que es único. dentro de tu proyecto de Google Cloud. No puedes cambiar el ID de partición más adelante.
- PARTITION_CONFIG: Es el identificador permanente de tu partición. de la partición, que define la ubicación geográfica de la partición y afecta dónde se almacenan.
- PARTITION_DESCRIPTION: Es el nombre que se mostrará para la partición. en la consola de Google Cloud. El nombre de la partición debe ser único en tu proyecto de Google Cloud.
- INSTANCE_ID: El identificador permanente de tu Instancia de Spanner en la que reside esta partición.
- NODE_COUNT: La capacidad de procesamiento de la partición, expresada como un número de nodos. Un nodo equivale a 1,000 unidades de procesamiento.
- PROCESSING_UNIT_COUNT: La capacidad de procesamiento de la instancia. expresada como un número de unidades de procesamiento. Tu partición debe tener al menos al menos 1,000 unidades de procesamiento. Ingresar cantidades en múltiplos de 1000 (1000, 2000, 3000, etc.).
Por ejemplo, para crear una partición europe-partition
en eur3
con 5 nodos,
ejecuta lo siguiente:
gcloud beta spanner instance-partitions create europe-partition --config=eur3 \
--description="europe-partition" --instance=test-instance --nodes=5
C++
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Go
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Java
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Node.js
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
PHP
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Python
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta Bibliotecas cliente de Spanner.
Describe una partición
gcloud
Para describir una partición, usa
gcloud beta spanner instance-partitions describe
gcloud beta spanner instance-partitions describe PARTITION_ID \ --instance=INSTANCE_ID
Reemplaza lo siguiente:
- PARTITION_ID: Es el identificador permanente de la partición.
- INSTANCE_ID: Es el identificador permanente de la instancia.
Por ejemplo, para describir la partición europe-partition
,
ejecuta lo siguiente:
gcloud beta spanner instance-partitions describe europe-partition
--instance=test-instance
Mostrar lista de particiones
Console
En la consola de Google Cloud, abre la página de Spanner.
Elige una instancia de la lista.
En el menú de navegación, selecciona Particiones.
Aparecerá una lista de particiones asociadas con esa instancia.
gcloud
Para enumerar las particiones, usa
gcloud beta spanner instance-partitions list
gcloud beta spanner instance-partitions list --instance=INSTANCE_ID
Gcloud CLI imprime una lista de tus instancias particiones, junto con el ID, el nombre visible, la configuración y la capacidad de procesamiento.
Edita una partición
En la siguiente sección, se explica cómo cambiar la capacidad de procesamiento de tu por cada partición. No puedes cambiar el ID, el nombre ni la configuración de la partición.
Cambia la capacidad de procesamiento
Debes aprovisionar suficiente capacidad de procesamiento para mantener Uso de CPU y de almacenamiento por debajo de la valores máximos. Para obtener más información, consulta las cuotas y límites de Spanner
Si quieres aumentar la capacidad de procesamiento de una partición, El proyecto de Google Cloud debe tener una cuota suficiente para agregar el procesamiento la capacidad de procesamiento. El tiempo que demore en completarse la solicitud de aumento depende del el tamaño de la solicitud. En la mayoría de los casos, las solicitudes se completan en unos minutos. Activada en muy pocas ocasiones, el escalamiento vertical puede tardar hasta una hora en completarse.
Console
En la consola de Google Cloud, abre la página de Spanner.
Elige una instancia de la lista.
En el menú de navegación, selecciona Particiones.
En la lista de particiones, debajo de la columna Acciones, haz clic en Más. Actions y selecciona Edit.
Elige una unidad de medida para cambiar la capacidad de procesamiento (unidades de procesamiento o nodos) y, luego, ingresa una cantidad. Al usar unidades de procesamiento, ingresar las cantidades en múltiplos de 1000 (1,000, 2,000, 3,000, etcétera). Cada nodo equivale a 1,000 unidades de procesamiento.
Tu partición debe tener al menos un nodo (1,000 unidades de procesamiento).
Haz clic en Guardar.
Si ves un diálogo que indica que tienes una cuota insuficiente para agregar recursos , sigue las instrucciones para solicitar una cuota más alta.
gcloud
Para cambiar la capacidad de procesamiento de tu partición, usa
gcloud beta spanner instance-partitions update
Cuando uses este comando, especifica la capacidad de procesamiento como una
la cantidad de nodos o unidades de procesamiento.
gcloud beta spanner instance-partitions update PARTITION_ID / --instance=INSTANCE_ID / [--nodes=NODE_COUNT | --processing-units=PROCESSING_UNIT_COUNT] [--async]
Reemplaza lo siguiente:
- PARTITION_ID: Es el identificador permanente de la partición.
- INSTANCE_ID: Es el identificador permanente de la instancia.
- NODE_COUNT: Es la nueva capacidad de procesamiento de la partición. expresada como un número de nodos. Un nodo equivale a 1,000 unidades de procesamiento.
- PROCESSING_UNIT_COUNT: Es la nueva capacidad de procesamiento de la expresada como un número de unidades de procesamiento. Tu partición debe tener al menos 1,000 unidades de procesamiento. Ingresar cantidades en múltiplos de 1000 (1000, 2000, 3000, etc.).
Marcas opcionales:
--async
: Usa esta marca si deseas que tu solicitud se muestre de inmediato. sin esperar a que la operación en curso finalice.
Para verificar el estado de tu solicitud, ejecuta
gcloud spanner operations describe
Borra una partición
No puedes borrar una partición mientras esté asociada a cualquier posición o dato. Primero debes mover los datos que estén en la partición o borrarlos las tablas de posiciones que usan la partición antes de borrar la partición.
Console
En la consola de Google Cloud, abre la página de Spanner.
Elige una instancia de la lista.
En el menú de navegación, selecciona Particiones.
En la lista de particiones, debajo de la columna Acciones, haz clic en Más. Acciones y selecciona Borrar.
Sigue las instrucciones para confirmar que quieres borrar la partición.
Haz clic en Borrar.
gcloud
Usa el comando gcloud beta spanner instance-partitions delete
.
gcloud beta spanner instance-partitions delete PARTITION_ID --instance=INSTANCE_ID
¿Qué sigue?
- Obtén información para crear y administrar claves y tablas de posiciones.