Crea y administra particiones de instancias

Versión preliminar — Geo-partitioning

Esta función está con sujeción a las "Condiciones de las Ofertas de la Fase Previa a la DG" de la sección Términos Generales del Servicio de los Términos Específicos del Servicio. Las funciones de la fase previa a la DG están disponibles sin modificaciones y pueden tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Nota: Esta función está disponible en la edición Spanner Enterprise Plus. Para obtener más información, consulta la descripción general de las ediciones de Spanner.

En esta página, se describe cómo crear y administrar particiones de instancias de Spanner.

Crea una partición de instancia

Console

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

   Ir a Spanner

2. Selecciona la instancia en la que deseas agregar particiones de instancias.

3. En el menú de navegación, selecciona Particiones de instancias.

4. Haz clic en Create instance partition.

5. Ingresa un ID de partición de instancia para identificar de forma permanente la partición de tu instancia. El ID de partición de la instancia también debe ser único dentro de la instancia. No podrás cambiar el ID de la partición de la instancia más adelante.

6. En la sección Elige una configuración, selecciona Regional o Multirregional. Como alternativa, si deseas comparar las especificaciones entre las regiones, haz clic en Compara configuraciones regionales.

7. Selecciona una configuración en el menú desplegable.

8. En la sección Configurar capacidad de procesamiento, en Seleccionar unidad, haz clic en una de las siguientes opciones:

   • Nodos para instancias grandes. Un nodo equivale a 1,000 unidades de procesamiento.
   • Unidades de procesamiento para particiones de instancias pequeñas

   Para obtener más información, consulta Capacidad de procesamiento, nodos y unidades de procesamiento.

9. En Elige un modo de escalamiento, haz clic en una de las siguientes opciones:

   • Asignación manual si deseas establecer manualmente la capacidad de procesamiento para los recursos de procesamiento y costos fijos

     • Cantidad indica la cantidad de nodos o unidades de procesamiento que se usarán para esta instancia.

   • Ajuste de escala automático para permitir que Spanner agregue y quite capacidad de procesamiento automáticamente El ajuste de escala automático administrado está disponible en las ediciones Enterprise y Enterprise Plus de Spanner. Para obtener más información sobre el escalador automático administrado, consulta Escalador automático administrado para Spanner. Configura las siguientes opciones del escalador automático administrado:

     • Mínimo indica el límite mínimo para reducir la escala, según la unidad de medida que elijas para Capacidad de procesamiento. Para obtener más información, consulta Cómo determinar el límite mínimo.
     • Máximo indica el límite máximo hasta el que se puede escalar, según la unidad de medida que elijas para la capacidad de procesamiento. Para obtener más información, consulta Cómo determinar el límite máximo.
     • El objetivo de uso de CPU de alta prioridad indica el porcentaje objetivo de CPU que se debe usar para las tareas de alta prioridad. Para obtener más información, consulta Determina el objetivo de uso de CPU.
     • El objetivo de uso total de CPU indica el porcentaje objetivo de CPU que se usará para todas las tareas de prioridad baja, media y alta. Para obtener más información, consulta Cómo determinar el objetivo de uso total de CPU.
     • El objetivo de uso de almacenamiento indica el porcentaje objetivo de almacenamiento que se debe usar. Para obtener más información, consulta Cómo determinar el objetivo de utilización del almacenamiento.

10. Haz clic en Crear para crear la partición de la instancia.

gcloud

Para crear una partición de instancia, usa gcloud spanner instance-partitions create.

gcloud spanner instance-partitions create INSTANCE_PARTITION_ID \
  --config=INSTANCE_PARTITION_CONFIG \
  --description="INSTANCE_PARTITION_DESCRIPTION" \
  --instance=INSTANCE_ID \
  [--nodes=NODE_COUNT | --processing-units=PROCESSING_UNIT_COUNT]

Reemplaza lo siguiente:

• INSTANCE_PARTITION_ID: Es el identificador permanente de la partición de la instancia, que es único dentro de tu instancia. No podrás cambiar el ID de la partición de la instancia más adelante.
• INSTANCE_PARTITION_CONFIG: Es el identificador permanente de la configuración de la partición de la instancia, que define la ubicación geográfica de la partición de la instancia y afecta el lugar donde se almacenan los datos.
• INSTANCE_PARTITION_DESCRIPTION: Es el nombre que se mostrará para la partición de la instancia en la consola de Google Cloud . El nombre de la partición de la instancia debe ser único dentro de la instancia.
• INSTANCE_ID: Es el identificador permanente de tu instancia de Spanner en la que reside esta partición de instancia.
• NODE_COUNT: Es la capacidad de procesamiento de la partición de la instancia, expresada como una cantidad de nodos. Un nodo equivale a 1,000 unidades de procesamiento.
• PROCESSING_UNIT_COUNT: Es la capacidad de procesamiento de la instancia, expresada como una cantidad de unidades de procesamiento. La partición de tu instancia debe tener al menos 1,000 unidades de procesamiento. Ingresa cantidades en múltiplos de 1,000 (1,000, 2,000, 3,000, etcétera).

Por ejemplo, para crear una partición de instancia europe-partition en eur3 con 5 nodos, ejecuta el siguiente comando:

  gcloud spanner instance-partitions create europe-partition --config=eur3 \
    --description="europe-partition" --instance=test-instance --nodes=5

Usa el ajuste de escala automático administrado

Puedes usar el ajuste de escala automático administrado con el comando gcloud spanner instance-partitions create. Para obtener más información, consulta Escalador automático administrado.

Usa el siguiente comando para crear una partición de instancia con un autoescalador administrado:

  gcloud 
  spanner instance-partitions create INSTANCE_PARTITION_ID \
    --config=INSTANCE_PARTITION_CONFIG \
    --description="INSTANCE_PARTITION_DESCRIPTION" \
    --instance=INSTANCE_ID \
    --autoscaling-min-processing-units=MINIMUM_PROCESSING_UNITS \
    --autoscaling-max-processing-units=MAXIMUM_PROCESSING_UNITS \
    --autoscaling-high-priority-cpu-target=HIGH_PRIORITY_CPU_PERCENTAGE \
    --autoscaling-total-cpu-target=TOTAL_CPU_PERCENTAGE \
    --autoscaling-storage-target=STORAGE_PERCENTAGE

o

  gcloud spanner instance-partitions create INSTANCE_PARTITION_ID \
    --config=INSTANCE_PARTITION_CONFIG \
    --description="INSTANCE_PARTITION_DESCRIPTION" \
    --instance=INSTANCE_ID \
    --autoscaling-min-nodes=MINIMUM_NODES \
    --autoscaling-max-nodes=MAXIMUM_NODES \
    --autoscaling-high-priority-cpu-target=HIGH_PRIORITY_CPU_PERCENTAGE \
    --autoscaling-total-cpu-target=TOTAL_CPU_PERCENTAGE
    --autoscaling-storage-target=STORAGE_PERCENTAGE

Reemplaza lo siguiente:

• INSTANCE_PARTITION_ID: Es el identificador permanente de la partición de la instancia, que es único dentro de tu instancia. No podrás cambiar el ID de la partición de la instancia más adelante.
• INSTANCE_PARTITION_CONFIG: Es el identificador permanente de la configuración de la partición de la instancia, que define la ubicación geográfica de la partición de la instancia y afecta el lugar donde se almacenan los datos.
• INSTANCE_PARTITION_DESCRIPTION: Es el nombre que se mostrará para la partición de la instancia en la consola de Google Cloud . El nombre de la partición de la instancia debe ser único dentro de la instancia.
• INSTANCE_ID: Es el identificador permanente de tu instancia de Spanner en la que reside esta partición de instancia.
• MINIMUM_PROCESSING_UNITS o MINIMUM_NODES: Es la cantidad mínima de unidades de procesamiento o nodos cuando se reduce la escala. Para obtener más información, consulta Cómo determinar el límite mínimo.
• MAXIMUM_PROCESSING_UNITS o MAXIMUM_NODES: Es la cantidad máxima de unidades de procesamiento o nodos cuando se escala verticalmente. Para obtener más información, consulta Cómo determinar el límite máximo.
• HIGH_PRIORITY_CPU_PERCENTAGE: Es el porcentaje objetivo de CPU de alta prioridad que se usará, según la prioridad de la tarea. El porcentaje de CPU puede variar del 10 al 90%. Para obtener más información, consulta Cómo determinar el objetivo de uso de CPU de alta prioridad.
• TOTAL_CPU_PERCENTAGE: Es el porcentaje objetivo de la CPU de prioridad total que se usará. El objetivo de CPU total debe ser mayor que el objetivo de CPU de alta prioridad. El porcentaje de CPU puede variar del 10 al 90%. Para obtener más información, consulta Cómo determinar el objetivo de uso total de CPU.
• STORAGE_PERCENTAGE: Es el porcentaje objetivo de almacenamiento que se usará, de 10 a 99%. Para obtener más información, consulta Cómo determinar el objetivo de uso del almacenamiento.

Bibliotecas cliente

C++

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta las bibliotecas cliente de Spanner.

void CreateInstancePartition(
    google::cloud::spanner_admin::InstanceAdminClient client,
    std::string const& project_id, std::string const& instance_id,
    std::string const& instance_partition_id) {
  auto project = google::cloud::Project(project_id);
  auto in = google::cloud::spanner::Instance(project_id, instance_id);
  auto config = project.FullName() + "/instanceConfigs/nam3";

  google::spanner::admin::instance::v1::CreateInstancePartitionRequest request;
  request.set_parent(in.FullName());
  request.set_instance_partition_id(instance_partition_id);
  request.mutable_instance_partition()->set_display_name(
      "Test instance partition");
  request.mutable_instance_partition()->set_node_count(1);
  request.mutable_instance_partition()->set_config(config);

  auto instance_partition = client.CreateInstancePartition(request).get();
  if (!instance_partition) throw std::move(instance_partition).status();
  std::cout << "Created instance partition [" << instance_partition_id << "]:\n"
            << instance_partition->DebugString();
}

C#

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta las bibliotecas cliente de Spanner.

using Google.Cloud.Spanner.Admin.Instance.V1;
using Google.Cloud.Spanner.Common.V1;
using Google.LongRunning;
using System;

public class CreateInstancePartitionSample
{
    public InstancePartition CreateInstancePartition(string projectId, string instanceId, string instancePartitionId)
    {
        // Create the InstanceAdminClient instance.
        InstanceAdminClient instanceAdminClient = InstanceAdminClient.Create();

        // Initialize request parameters.
        InstancePartition partition = new InstancePartition
        {
            DisplayName = "This is a display name.",
            NodeCount = 1,
            ConfigAsInstanceConfigName = InstanceConfigName.FromProjectInstanceConfig(projectId, "nam3"),
        };
        InstanceName instanceName = InstanceName.FromProjectInstance(projectId, instanceId);

        // Make the CreateInstancePartition request.
        Operation<InstancePartition, CreateInstancePartitionMetadata> response = instanceAdminClient.CreateInstancePartition(instanceName, partition, instancePartitionId);

        Console.WriteLine("Waiting for the operation to finish.");

        // Poll until the returned long-running operation is complete.
        Operation<InstancePartition, CreateInstancePartitionMetadata> completedResponse = response.PollUntilCompleted();

        if (completedResponse.IsFaulted)
        {
            Console.WriteLine($"Error while creating instance partition: {completedResponse.Exception}");
            throw completedResponse.Exception;
        }

        Console.WriteLine($"Instance created successfully.");

        return completedResponse.Result;
    }
}

Go

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta las bibliotecas cliente de Spanner.

import (
	"context"
	"fmt"
	"io"

	instance "cloud.google.com/go/spanner/admin/instance/apiv1"
	"cloud.google.com/go/spanner/admin/instance/apiv1/instancepb"
)

// Example of creating an instance partition with Go.
// projectID is the ID of the project that the new instance partition will be in.
// instanceID is the ID of the instance that the new instance partition will be in.
// instancePartitionID is the ID of the new instance partition to be created.
func createInstancePartition(w io.Writer, projectID, instanceID, instancePartitionID string) error {
	// projectID := "my-project-id"
	// instanceID := "my-instance"
	// instancePartitionID := "my-instance-partition"
	ctx := context.Background()
	instanceAdmin, err := instance.NewInstanceAdminClient(ctx)
	if err != nil {
		return err
	}
	defer instanceAdmin.Close()

	op, err := instanceAdmin.CreateInstancePartition(ctx, &instancepb.CreateInstancePartitionRequest{
		Parent:              fmt.Sprintf("projects/%s/instances/%s", projectID, instanceID),
		InstancePartitionId: instancePartitionID,
		InstancePartition: &instancepb.InstancePartition{
			Config:          fmt.Sprintf("projects/%s/instanceConfigs/%s", projectID, "nam3"),
			DisplayName:     "my-instance-partition",
			ComputeCapacity: &instancepb.InstancePartition_NodeCount{NodeCount: 1},
		},
	})
	if err != nil {
		return fmt.Errorf("could not create instance partition %s: %w", fmt.Sprintf("projects/%s/instances/%s/instancePartitions/%s", projectID, instanceID, instancePartitionID), err)
	}
	// Wait for the instance partition creation to finish.
	i, err := op.Wait(ctx)
	if err != nil {
		return fmt.Errorf("waiting for instance partition creation to finish failed: %w", err)
	}
	// The instance partition may not be ready to serve yet.
	if i.State != instancepb.InstancePartition_READY {
		fmt.Fprintf(w, "instance partition state is not READY yet. Got state %v\n", i.State)
	}
	fmt.Fprintf(w, "Created instance partition [%s]\n", instancePartitionID)
	return nil
}

Java

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta las bibliotecas cliente de Spanner.

import com.google.cloud.spanner.Spanner;
import com.google.cloud.spanner.SpannerOptions;
import com.google.cloud.spanner.admin.instance.v1.InstanceAdminClient;
import com.google.spanner.admin.instance.v1.CreateInstancePartitionRequest;
import com.google.spanner.admin.instance.v1.InstanceConfigName;
import com.google.spanner.admin.instance.v1.InstanceName;
import com.google.spanner.admin.instance.v1.InstancePartition;
import java.util.concurrent.ExecutionException;

class CreateInstancePartitionSample {

  static void createInstancePartition() {
    // TODO(developer): Replace these variables before running the sample.
    String projectId = "my-project";
    String instanceId = "my-instance";
    String instancePartitionId = "my-instance-partition";
    createInstancePartition(projectId, instanceId, instancePartitionId);
  }

  static void createInstancePartition(
      String projectId, String instanceId, String instancePartitionId) {
    // Set instance partition configuration.
    int nodeCount = 1;
    String displayName = "Descriptive name";

    // Create an InstancePartition object that will be used to create the instance partition.
    InstancePartition instancePartition =
        InstancePartition.newBuilder()
            .setDisplayName(displayName)
            .setNodeCount(nodeCount)
            .setConfig(InstanceConfigName.of(projectId, "nam3").toString())
            .build();

    try (Spanner spanner =
            SpannerOptions.newBuilder().setProjectId(projectId).build().getService();
        InstanceAdminClient instanceAdminClient = spanner.createInstanceAdminClient()) {

      // Wait for the createInstancePartition operation to finish.
      InstancePartition createdInstancePartition =
          instanceAdminClient
              .createInstancePartitionAsync(
                  CreateInstancePartitionRequest.newBuilder()
                      .setParent(InstanceName.of(projectId, instanceId).toString())
                      .setInstancePartitionId(instancePartitionId)
                      .setInstancePartition(instancePartition)
                      .build())
              .get();
      System.out.printf(
          "Instance partition %s was successfully created%n", createdInstancePartition.getName());
    } catch (ExecutionException e) {
      System.out.printf(
          "Error: Creating instance partition %s failed with error message %s%n",
          instancePartition.getName(), e.getMessage());
    } catch (InterruptedException e) {
      System.out.println(
          "Error: Waiting for createInstancePartition operation to finish was interrupted");
    }
  }
}

Node.js

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta las bibliotecas cliente de Spanner.

// Imports the Google Cloud client library
const {Spanner} = require('@google-cloud/spanner');

/**
 * TODO(developer): Uncomment the following lines before running the sample.
 */
// const projectId = 'my-project-id';
// const instanceId = 'my-instance';
// const instancePartitionId = 'my-instance-partition';

// Creates a client
const spanner = new Spanner({
  projectId: projectId,
});

// Get the instance admin client
const instanceAdminClient = spanner.getInstanceAdminClient();

// Creates a new instance partition
try {
  console.log(
    `Creating instance partition ${instanceAdminClient.instancePartitionPath(
      projectId,
      instanceId,
      instancePartitionId,
    )}.`,
  );
  const [operation] = await instanceAdminClient.createInstancePartition({
    instancePartitionId: instancePartitionId,
    parent: instanceAdminClient.instancePath(projectId, instanceId),
    instancePartition: {
      config: instanceAdminClient.instanceConfigPath(projectId, 'nam3'),
      nodeCount: 1,
      displayName: 'Test instance partition',
    },
  });

  console.log(
    `Waiting for operation on ${instancePartitionId} to complete...`,
  );
  await operation.promise();

  console.log(`Created instance partition ${instancePartitionId}.`);
} catch (err) {
  console.error('ERROR:', err);
}

PHP

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta las bibliotecas cliente de Spanner.

use Google\Cloud\Spanner\Admin\Instance\V1\Client\InstanceAdminClient;
use Google\Cloud\Spanner\Admin\Instance\V1\CreateInstancePartitionRequest;
use Google\Cloud\Spanner\Admin\Instance\V1\InstancePartition;

/**
 * Creates an instance partition.
 * Example:
 * ```
 * create_instance_partition($projectId, $instanceId, $instancePartitionId);
 * ```
 *
 * @param string $projectId The Google Cloud project ID.
 * @param string $instanceId The Spanner instance ID.
 * @param string $instancePartitionId The instance partition ID.
 */
function create_instance_partition(string $projectId, string $instanceId, string $instancePartitionId): void
{
    $instanceAdminClient = new InstanceAdminClient();

    $instanceName = $instanceAdminClient->instanceName($projectId, $instanceId);
    $instancePartitionName = $instanceAdminClient->instancePartitionName($projectId, $instanceId, $instancePartitionId);
    $configName = $instanceAdminClient->instanceConfigName($projectId, 'nam3');

    $instancePartition = (new InstancePartition())
        ->setConfig($configName)
        ->setDisplayName('Test instance partition.')
        ->setNodeCount(1);

    $operation = $instanceAdminClient->createInstancePartition(
        (new CreateInstancePartitionRequest())
        ->setParent($instanceName)
        ->setInstancePartitionId($instancePartitionId)
        ->setInstancePartition($instancePartition)
    );

    print('Waiting for operation to complete...' . PHP_EOL);
    $operation->pollUntilComplete();

    printf('Created instance partition %s' . PHP_EOL, $instancePartitionId);
}

Python

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Spanner, consulta las bibliotecas cliente de Spanner.

def create_instance_partition(instance_id, instance_partition_id):
    """Creates an instance partition."""
    from google.cloud.spanner_admin_instance_v1.types import spanner_instance_admin

    spanner_client = spanner.Client()
    instance_admin_api = spanner_client.instance_admin_api

    config_name = "{}/instanceConfigs/nam3".format(spanner_client.project_name)

    operation = spanner_client.instance_admin_api.create_instance_partition(
        parent=instance_admin_api.instance_path(spanner_client.project, instance_id),
        instance_partition_id=instance_partition_id,
        instance_partition=spanner_instance_admin.InstancePartition(
            config=config_name,
            display_name="Test instance partition",
            node_count=1,
        ),
    )

    print("Waiting for operation to complete...")
    operation.result(OPERATION_TIMEOUT_SECONDS)

    print("Created instance partition {}".format(instance_partition_id))

Describe una partición de instancia

gcloud

Para describir una partición de instancia, usa gcloud spanner instance-partitions describe.

gcloud spanner instance-partitions describe PARTITION_ID \
  --instance=INSTANCE_ID

Reemplaza lo siguiente:

• INSTANCE_PARTITION_ID: Es el identificador permanente de la partición de la instancia.
• INSTANCE_ID: Es el identificador permanente de la instancia.

Por ejemplo, para describir la partición de la instancia europe-partition, ejecuta el siguiente comando:

  gcloud spanner instance-partitions describe europe-partition
    --instance=test-instance

Enumera particiones de instancias

Console

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

   Ir a Spanner

2. Elige una instancia de la lista.

3. En el menú de navegación, selecciona Particiones de instancias.

   Se muestra una lista de las particiones de instancias asociadas a esa instancia.

gcloud

Para enumerar las particiones de tu instancia, usa gcloud spanner instance-partitions list.

gcloud spanner instance-partitions list --instance=INSTANCE_ID

Gcloud CLI imprime una lista de las particiones de tu instancia de Spanner, junto con el ID, el nombre visible, la configuración y la capacidad de procesamiento de cada partición de la instancia.

Cómo editar una partición de instancia

En la siguiente sección, se explica cómo cambiar la capacidad de procesamiento de la partición de la instancia. No puedes cambiar el ID, el nombre ni la configuración de la partición de la instancia.

Cómo cambiar la capacidad de procesamiento

Debes aprovisionar suficiente capacidad de procesamiento para mantener el uso de CPU y el uso de almacenamiento por debajo de los valores máximos recomendados. Para obtener más información, consulta las cuotas y los límites de Spanner.

Si deseas aumentar la capacidad de procesamiento de una partición de instancia, tu proyecto deGoogle Cloud debe tener una cuota suficiente para agregar la capacidad de procesamiento. El tiempo que tarda en completarse la solicitud de aumento depende de su tamaño. En la mayoría de los casos, las solicitudes se completan en pocos minutos. En ocasiones excepcionales, el aumento de escala puede tardar hasta una hora en completarse.

Console

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

   Ir a Spanner

2. Elige una instancia de la lista.

3. En el menú de navegación, selecciona Particiones de instancias.

4. En la lista de particiones de instancias, en la columna Acciones, haz clic en Más acciones y selecciona Editar.

5. Para cambiar la capacidad de procesamiento, elige una unidad de medida (unidades de procesamiento o nodos) y, luego, ingresa una cantidad. Cuando uses unidades de procesamiento, ingresa cantidades en múltiplos de 1,000 (1,000, 2,000, 3,000, etcétera). Cada nodo equivale a 1,000 unidades de procesamiento.

   La partición de tu instancia debe tener al menos un nodo (1,000 unidades de procesamiento).

6. Haz clic en Guardar.

   Si ves un cuadro de diálogo que indica que tienes una cuota insuficiente para agregar capacidad de procesamiento , sigue las instrucciones a fin de solicitar una cuota superior.

gcloud

Para cambiar la capacidad de procesamiento de la partición de tu instancia, usa gcloud spanner instance-partitions update. Cuando uses este comando, especifica la capacidad de procesamiento como una cantidad de nodos o unidades de procesamiento.

gcloud spanner instance-partitions update INSTANCE_PARTITION_ID \
  --instance=INSTANCE_ID \
  [--nodes=NODE_COUNT | --processing-units=PROCESSING_UNIT_COUNT]
  [--async]

Reemplaza lo siguiente:

• INSTANCE_PARTITION_ID: Es el identificador permanente de la partición de la instancia.
• INSTANCE_ID: Es el identificador permanente de la instancia.
• NODE_COUNT: Es la nueva capacidad de procesamiento de la partición de la instancia, expresada como una cantidad de nodos. Un nodo equivale a 1,000 unidades de procesamiento.
• PROCESSING_UNIT_COUNT: Es la nueva capacidad de procesamiento de la partición de la instancia, expresada como una cantidad de unidades de procesamiento. La partición de tu instancia debe tener al menos 1,000 unidades de procesamiento. Ingresa cantidades en múltiplos de 1,000 (1,000, 2,000, 3,000, etcétera).

Marcas opcionales:

• --async: Usa esta marca si deseas que tu solicitud se muestre de inmediato, sin esperar a que se complete la operación en curso.

Para verificar el estado de tu solicitud, ejecuta gcloud spanner operations describe.

Habilita o modifica el escalador automático administrado en una partición de instancias

Se aplican las siguientes limitaciones cuando habilitas o cambias la función de ajuste de escala automático administrado en una partición de instancia existente:

• No puedes mover una instancia mientras el ajuste de escala automático administrado esté habilitado.

Console

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

   Ir a Spanner

2. Elige una instancia de la lista.

3. En el menú de navegación, selecciona Particiones de instancias.

4. En la lista de particiones de instancias, en la columna Acciones, haz clic en Más acciones y selecciona Editar.

5. En Configurar la capacidad de procesamiento, haz clic en Ajuste de escala automático.

6. En Mínimo, selecciona el límite mínimo que se usará cuando se reduzca la escala. Para obtener más información, consulta Cómo determinar el límite mínimo.

7. En Máximo, selecciona el límite máximo que se usará cuando se aumente la escala. Para obtener más información, consulta Cómo determinar el límite máximo.

8. En Objetivo de uso de CPU de alta prioridad, ingresa el porcentaje de CPU que se usará para las tareas de alta prioridad. Para obtener más información, consulta Cómo determinar el objetivo de uso de CPU.

9. En Objetivo de uso total de CPU, ingresa el porcentaje objetivo de CPU que se usará para todas las tareas de prioridad baja, media y alta. El porcentaje de CPU puede variar del 10 al 90%. Para obtener más información, consulta Cómo determinar el objetivo de uso total de CPU.

10. En Objetivo de uso de almacenamiento, ingresa el porcentaje de almacenamiento que se usará. Para obtener más información, consulta Cómo determinar el objetivo de uso del almacenamiento.

11. Haz clic en Guardar.

gcloud

Usa el comando gcloud spanner instance-partitions update para habilitar el escalador automático administrado en una partición de instancias. Para obtener más información y conocer las limitaciones, consulta Limitaciones y marcas de Google Cloud CLI.

Puedes agregar el escalador automático administrado con el siguiente comando:

  gcloud spanner instance-partitions update INSTANCE_PARTITION_ID \
    --instance=INSTANCE_ID \
    --autoscaling-min-processing-units=MINIMUM_PROCESSING_UNITS \
    --autoscaling-max-processing-units=MAXIMUM_PROCESSING_UNITS \
    --autoscaling-high-priority-cpu-target=HIGH_PRIORITY_CPU_PERCENTAGE \
    --autoscaling-total-cpu-target=TOTAL_CPU_PERCENTAGE \
    --autoscaling-storage-target=STORAGE_PERCENTAGE

o

  gcloud spanner instance-partitions update INSTANCE_PARTITION_ID \
    --instance=INSTANCE_ID \
    --autoscaling-min-nodes=MINIMUM_NODES \
    --autoscaling-max-nodes=MAXIMUM_NODES \
    --autoscaling-high-priority-cpu-target=HIGH_PRIORITY_CPU_PERCENTAGE \
    --autoscaling-total-cpu-target=TOTAL_CPU_PERCENTAGE \
    --autoscaling-storage-target=STORAGE_PERCENTAGE

Reemplaza lo siguiente:

• INSTANCE_PARTITION_ID: Es el identificador permanente de la partición de la instancia.
• INSTANCE_ID: Es el identificador permanente de la instancia.
• MINIMUM_PROCESSING_UNITS o MINIMUM_NODES: Es la cantidad mínima de unidades de procesamiento o nodos que se deben usar cuando se reduce la escala. Para obtener más información, consulta Cómo determinar el límite mínimo.
• MAXIMUM_PROCESSING_UNITS o MAXIMUM_NODES: Es la cantidad máxima de unidades de procesamiento o nodos que se pueden usar cuando se escala verticalmente. Para obtener más información, consulta Cómo determinar el límite máximo.
• HIGH_PRIORITY_CPU_PERCENTAGE: Es el porcentaje objetivo de CPU de alta prioridad que se usará, según la prioridad de la tarea. El porcentaje de CPU puede variar del 10 al 90%. Para obtener más información, consulta Cómo determinar el objetivo de uso de CPU de alta prioridad.
• TOTAL_CPU_PERCENTAGE: Es el porcentaje objetivo de la CPU de prioridad total que se usará. El objetivo de CPU total debe ser mayor que el objetivo de CPU de alta prioridad. El porcentaje de CPU puede variar del 10 al 90%. Para obtener más información, consulta Cómo determinar el objetivo de uso total de CPU.
• STORAGE_PERCENTAGE: Es el porcentaje objetivo de almacenamiento que se usará, del 10% al 99%. Para obtener más información, consulta Cómo determinar el objetivo de utilización del almacenamiento.

Después de habilitar el escalador automático administrado en una partición de instancias, también puedes modificar su configuración. Por ejemplo, si deseas aumentar la cantidad máxima de unidades de procesamiento a 10,000, ejecuta el siguiente comando:

gcloud spanner instance-partitions update test-instance-partition \
     --instance=test-instance
     --autoscaling-max-processing-units=10000

Cómo cambiar una partición de instancia para que use el escalador automático administrado en lugar del escalado manual

Console

1. Ve a la página Instancias de Spanner en la Google Cloud consola.

   Ir a la página Instancias

2. Elige una instancia de la lista.

3. En el menú de navegación, selecciona Particiones de instancias.

4. En la lista de particiones de instancias, en la columna Acciones, haz clic en Más acciones y selecciona Editar.

5. En Elige un modo de asignación, marca la casilla Asignación manual.

6. Haz clic en Guardar.

gcloud

Usa el comando gcloud spanner instance-partitions update para actualizar la partición de la instancia.

Usa el siguiente comando para cambiar una partición de instancia del uso del escalador automático administrado al ajuste de escala manual:

  gcloud spanner instance-partitions update INSTANCE_PARTITION_ID \
    --instance=INSTANCE_ID \
  --processing-units=PROCESSING_UNIT_COUNT

o

  gcloud spanner instance-partitions update INSTANCE_PARTITION_ID \
    --instance=INSTANCE_ID \
  --nodes=NODE_COUNT

Reemplaza lo siguiente:

• INSTANCE_PARTITION_ID: Es el identificador permanente de la partición de la instancia.
• INSTANCE_ID: Es el identificador permanente de la instancia.
• NODE_COUNT: Es la capacidad de procesamiento de la instancia, expresada como una cantidad de nodos. Cada nodo equivale a 1,000 unidades de procesamiento.
• PROCESSING_UNIT_COUNT: Es la capacidad de procesamiento de la instancia, expresada como una cantidad de unidades de procesamiento. La cantidad mínima de unidades de procesamiento para una partición de instancia es de 1,000.

Borra una partición de instancia

No puedes borrar una partición de instancia mientras esté asociada a alguna posición o dato. Primero debes mover los datos que se encuentran en la partición de la instancia o borrar las tablas de colocación que usan la partición de la instancia antes de poder borrarla.

Console

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

   Ir a Spanner

2. Elige una instancia de la lista.

3. En el menú de navegación, selecciona Particiones de instancias.

4. En la lista de particiones de instancias, en la columna Acciones, haz clic en Más acciones y selecciona Borrar.

5. Sigue las instrucciones para confirmar que deseas borrar la partición de la instancia.

6. Haz clic en Borrar.

gcloud

Usa el comando gcloud spanner instance-partitions delete.

gcloud spanner instance-partitions delete INSTANCE_PARTITION_ID
  --instance=INSTANCE_ID

¿Qué sigue?

• Obtén más información para crear y administrar tablas y claves de posiciones.