Instanzpartitionen erstellen und verwalten

Vorabversion — Geopartitionierung

Diese Funktion unterliegt den „Bedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA‑Funktionen stehen in der vorliegenden Form zur Verfügung und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie unter den Beschreibungen der Startphase.

Hinweis: Diese Funktion ist in der Spanner Enterprise Plus-Version verfügbar. Weitere Informationen finden Sie in der Übersicht über Spanner-Versionen.

Auf dieser Seite wird beschrieben, wie Sie Spanner-Instanzpartitionen erstellen und verwalten.

Instanzpartition erstellen

Console

1. Öffnen Sie in der Google Cloud Console die Seite Spanner.

   Spanner aufrufen

2. Wählen Sie die Instanz aus, der Sie Instanzpartitionen hinzufügen möchten.

3. Wählen Sie im Navigationsmenü Instanzpartitionen aus.

4. Klicken Sie auf Instanzpartition erstellen.

5. Geben Sie eine Instanzpartitions-ID ein, um Ihre Instanzpartition dauerhaft zu identifizieren. Die Instanzpartitions-ID muss innerhalb Ihrer Instanz eindeutig sein. Sie können die Instanzpartitions-ID später nicht mehr ändern.

6. Wählen Sie im Bereich Konfiguration auswählen die Option Regional oder Multiregional aus. Wenn Sie die Spezifikationen zwischen den Regionen vergleichen möchten, klicken Sie alternativ auf Regionskonfigurationen vergleichen.

7. Wählen Sie im Drop-down-Menü eine Konfiguration aus.

8. Klicken Sie im Abschnitt Rechenkapazität konfigurieren unter Einheit auswählen auf eine der folgenden Optionen:

   • Knoten für große Instanzen. Ein Knoten entspricht 1.000 Verarbeitungseinheiten.
   • Verarbeitungseinheiten für kleine Instanzpartitionen.

   Weitere Informationen finden Sie unter Rechenkapazität, Knoten und Verarbeitungseinheiten.

9. Klicken Sie unter Skalierungsmodus auswählen auf eine der folgenden Optionen:

   • Manuelle Zuweisung, wenn Sie die Rechenkapazität für feste Rechenressourcen und -kosten manuell festlegen möchten.

     • Menge gibt die Anzahl der Verarbeitungseinheiten oder Knoten an, die für diese Instanz verwendet werden sollen.

   • Autoscaling, damit Spanner Rechenkapazität automatisch hinzufügen und entfernen kann. Das verwaltete Autoscaling ist in der Spanner Enterprise-Version und Enterprise Plus-Version verfügbar. Weitere Informationen zum verwalteten Autoscaler finden Sie unter Verwalteter Autoscaler für Cloud Spanner. Konfigurieren Sie die folgenden Optionen für das verwaltete Autoscaling:

     • Minimum gibt das Mindestlimit für das Herunterskalieren an, je nach der Maßeinheit, die Sie für die Rechenkapazität auswählen. Weitere Informationen finden Sie unter Mindestlimit bestimmen.
     • Maximum gibt das maximale Limit für die Hochskalierung an, je nach der Maßeinheit, die Sie für die Rechenkapazität auswählen. Weitere Informationen finden Sie unter Maximale Beschränkung bestimmen.
     • CPU-Auslastungsziel mit hoher Priorität gibt den Zielprozentsatz der CPU an, der für Aufgaben mit hoher Priorität verwendet werden soll. Weitere Informationen finden Sie unter CPU-Auslastungsziel bestimmen.
     • Ziel für gesamte CPU-Auslastung gibt den Zielprozentsatz der CPU an, der für alle Aufgaben mit niedriger, mittlerer und hoher Priorität verwendet werden soll. Weitere Informationen finden Sie unter Ziel für die gesamte CPU-Auslastung bestimmen.
     • Speicherauslastungsziel gibt den Zielprozentsatz des zu verwendenden Speichers an. Weitere Informationen finden Sie unter Ziel für die Speicherauslastung bestimmen.

10. Klicken Sie auf Erstellen, um die Instanzpartition zu erstellen.

gcloud

Verwenden Sie zum Erstellen einer Instanzpartition 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]

Ersetzen Sie Folgendes:

• INSTANCE_PARTITION_ID: die permanente Kennung der Instanzpartition, die innerhalb Ihrer Instanz eindeutig ist. Sie können die Instanzpartitions-ID später nicht mehr ändern.
• INSTANCE_PARTITION_CONFIG: die permanente Kennung der Instanzpartitionskonfiguration, die den geografischen Standort der Instanzpartition definiert und sich darauf auswirkt, wo Daten gespeichert werden.
• INSTANCE_PARTITION_DESCRIPTION: der Name, der für die Instanzpartition in der Google Cloud Console angezeigt werden soll. Der Name der Instanzpartition muss innerhalb Ihrer Instanz eindeutig sein.
• INSTANCE_ID: die permanente Kennung Ihrer Spanner-Instanz, in der sich diese Instanzpartition befindet.
• NODE_COUNT: die Rechenkapazität der Instanzpartition, ausgedrückt als Anzahl von Knoten. Ein Knoten entspricht 1.000 Verarbeitungseinheiten.
• PROCESSING_UNIT_COUNT: die Rechenkapazität der Instanz, ausgedrückt als Anzahl von Verarbeitungseinheiten. Ihre Instanzpartition muss mindestens 1.000 Verarbeitungseinheiten haben. Geben Sie Mengen in Vielfachen von 1.000 ein (1.000, 2.000, 3.000 usw.).

Wenn Sie beispielsweise eine Instanzpartition europe-partition in eur3 mit 5 Knoten erstellen möchten, führen Sie Folgendes aus:

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

Verwaltetes Autoscaling verwenden

Sie können das verwaltete Autoscaling mit dem Befehl gcloud spanner instance-partitions create verwenden. Weitere Informationen finden Sie unter Verwaltetes Autoscaling.

Verwenden Sie den folgenden Befehl, um eine Instanzpartition mit verwaltetem Autoscaling zu erstellen:

  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

oder

  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

Ersetzen Sie Folgendes:

• INSTANCE_PARTITION_ID: die permanente Kennung der Instanzpartition, die innerhalb Ihrer Instanz eindeutig ist. Sie können die Instanzpartitions-ID später nicht mehr ändern.
• INSTANCE_PARTITION_CONFIG: die permanente Kennung der Instanzpartitionskonfiguration, die den geografischen Standort der Instanzpartition definiert und sich darauf auswirkt, wo Daten gespeichert werden.
• INSTANCE_PARTITION_DESCRIPTION: der Name, der für die Instanzpartition in der Google Cloud Console angezeigt werden soll. Der Name der Instanzpartition muss innerhalb Ihrer Instanz eindeutig sein.
• INSTANCE_ID: die permanente Kennung Ihrer Spanner-Instanz, in der sich diese Instanzpartition befindet.
• MINIMUM_PROCESSING_UNITS oder MINIMUM_NODES: Die Mindestanzahl von Verarbeitungseinheiten oder Knoten beim Herunterskalieren. Weitere Informationen finden Sie unter Mindestlimit bestimmen.
• MAXIMUM_PROCESSING_UNITS oder MAXIMUM_NODES: die maximale Anzahl von Verarbeitungseinheiten oder Knoten beim Hochskalieren. Weitere Informationen finden Sie unter Höchstgrenze ermitteln.
• HIGH_PRIORITY_CPU_PERCENTAGE: der Zielprozentsatz der CPU mit hoher Priorität, der basierend auf der Priorität der Aufgabe verwendet werden soll. Der CPU-Prozentsatz kann zwischen 10 % und 90 % liegen. Weitere Informationen finden Sie unter Ziel für die CPU-Auslastung mit hoher Priorität bestimmen.
• TOTAL_CPU_PERCENTAGE: der Zielprozentsatz der gesamten CPU-Priorität, die verwendet werden soll. Das Ziel für die gesamte CPU-Auslastung muss größer sein als das Ziel für die CPU-Auslastung mit hoher Priorität. Der CPU-Prozentsatz kann zwischen 10 % und 90 % liegen. Weitere Informationen finden Sie unter Ziel für die gesamte CPU-Auslastung bestimmen.
• STORAGE_PERCENTAGE: der Zielprozentsatz des zu verwendenden Speichers, von 10 bis 99 %. Weitere Informationen finden Sie unter Ziel für die Speicherauslastung festlegen.

Clientbibliotheken

C++

Informationen zum Installieren und Verwenden der Clientbibliothek für Cloud Spanner finden Sie unter Cloud Spanner-Clientbibliotheken.

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#

Informationen zum Installieren und Verwenden der Clientbibliothek für Cloud Spanner finden Sie unter Cloud Spanner-Clientbibliotheken.

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

Informationen zum Installieren und Verwenden der Clientbibliothek für Cloud Spanner finden Sie unter Cloud Spanner-Clientbibliotheken.

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

Informationen zum Installieren und Verwenden der Clientbibliothek für Cloud Spanner finden Sie unter Cloud Spanner-Clientbibliotheken.

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

Informationen zum Installieren und Verwenden der Clientbibliothek für Cloud Spanner finden Sie unter Cloud Spanner-Clientbibliotheken.

// 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

Informationen zum Installieren und Verwenden der Clientbibliothek für Cloud Spanner finden Sie unter Cloud Spanner-Clientbibliotheken.

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

Informationen zum Installieren und Verwenden der Clientbibliothek für Cloud Spanner finden Sie unter Cloud Spanner-Clientbibliotheken.

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))

Instanzpartition beschreiben

gcloud

Verwenden Sie gcloud spanner instance-partitions describe, um eine Instanzpartition zu beschreiben.

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

Ersetzen Sie Folgendes:

• INSTANCE_PARTITION_ID: die permanente Kennung der Instanzpartition.
• INSTANCE_ID: Die permanente Kennzeichnung der Instanz.

Führen Sie beispielsweise Folgendes aus, um die Instanzpartition europe-partition zu beschreiben:

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

Instanzpartitionen auflisten

Console

1. Öffnen Sie in der Google Cloud Console die Seite Spanner.

   Spanner aufrufen

2. Wählen Sie eine Instanz aus der Liste aus.

3. Wählen Sie im Navigationsmenü Instanzpartitionen aus.

   Eine Liste der Instanzpartitionen, die dieser Instanz zugeordnet sind, wird angezeigt.

gcloud

Verwenden Sie gcloud spanner instance-partitions list, um Ihre Instanzpartitionen aufzulisten.

gcloud spanner instance-partitions list --instance=INSTANCE_ID

Die Google Cloud CLI gibt eine Liste Ihrer Spanner-Instanzpartitionen aus, zusammen mit der ID, dem Anzeigenamen, der Konfiguration und der Rechenkapazität jeder Instanzpartition.

Instanzpartition bearbeiten

Im folgenden Abschnitt wird beschrieben, wie Sie die Rechenkapazität Ihrer Instanzpartition ändern. Sie können die ID, den Namen oder die Konfiguration der Instanzpartition nicht ändern.

Rechenkapazität ändern

Sie müssen genügend Rechenkapazität bereitstellen, um die CPU-Auslastung und die Speicherauslastung unter den empfohlenen Höchstwerten zu halten. Weitere Informationen finden Sie unter Kontingente und Limits für Cloud Spanner.

Wenn Sie die Rechenkapazität einer Instanzpartition erhöhen möchten, muss IhrGoogle Cloud -Projekt ein ausreichendes Kontingent haben, um die Rechenkapazität hinzuzufügen. Wie lange es dauert, bis die Anfrage zur Erhöhung abgeschlossen ist, hängt von der Größe der Anfrage ab. In den meisten Fällen werden Anfragen innerhalb weniger Minuten abgeschlossen. In seltenen Fällen kann eine Hochskalierung bis zu einer Stunde dauern.

Console

1. Öffnen Sie in der Google Cloud Console die Seite Spanner.

   Spanner aufrufen

2. Wählen Sie eine Instanz aus der Liste aus.

3. Wählen Sie im Navigationsmenü Instanzpartitionen aus.

4. Klicken Sie in der Liste der Instanzpartitionen in der Spalte Aktionen auf Weitere Aktionen und wählen Sie Bearbeiten aus.

5. Ändern Sie die Rechenkapazität, indem Sie eine Maßeinheit (Verarbeitungseinheiten oder Knoten) auswählen und dann eine Menge eingeben. Wenn Sie Verarbeitungseinheiten verwenden, geben Sie Mengen in Vielfachen von 1.000 ein (1.000, 2.000, 3.000 usw.). Jeder Knoten entspricht 1.000 Verarbeitungseinheiten.

   Ihre Instanzpartition muss mindestens einen Knoten (1.000 Verarbeitungseinheiten) haben.

6. Klicken Sie auf Speichern.

   Wenn ein Dialogfeld angezeigt wird, in dem Sie darauf hingewiesen werden, dass Ihr Kontingent nicht ausreicht, um Rechenkapazität hinzuzufügen, folgen Sie der Anleitung, um ein höheres Kontingent anzufordern.

gcloud

Verwenden Sie gcloud spanner instance-partitions update, um die Rechenkapazität Ihrer Instanzpartition zu ändern. Geben Sie bei Verwendung dieses Befehls die Rechenkapazität als Anzahl von Knoten oder Verarbeitungseinheiten an.

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

Ersetzen Sie Folgendes:

• INSTANCE_PARTITION_ID: die permanente Kennung der Instanzpartition.
• INSTANCE_ID: Die permanente Kennzeichnung der Instanz.
• NODE_COUNT: die neue Rechenkapazität der Instanzpartition, ausgedrückt als Anzahl von Knoten. Ein Knoten entspricht 1.000 Verarbeitungseinheiten.
• PROCESSING_UNIT_COUNT: die neue Rechenkapazität der Instanzpartition, ausgedrückt als Anzahl von Verarbeitungseinheiten. Ihre Instanzpartition muss mindestens 1.000 Verarbeitungseinheiten haben. Geben Sie Mengen in Vielfachen von 1.000 ein (1.000, 2.000, 3.000 usw.).

Optionale Flags:

• --async: Verwenden Sie dieses Flag, wenn die Anfrage sofort zurückgegeben werden soll, ohne auf den Abschluss des laufenden Vorgangs zu warten.

Sie können den Status Ihrer Anfrage prüfen, indem Sie gcloud spanner operations describe ausführen.

Verwaltetes Autoscaling auf einer Instanzpartition aktivieren oder ändern

Die folgenden Einschränkungen gelten, wenn Sie das verwaltete Autoscaling für eine vorhandene Instanzpartition aktivieren oder ändern:

• Sie können eine Instanz nicht verschieben, solange der verwaltete Autoscaler aktiviert ist.

Console

1. Öffnen Sie in der Google Cloud Console die Seite Spanner.

   Spanner aufrufen

2. Wählen Sie eine Instanz aus der Liste aus.

3. Wählen Sie im Navigationsmenü Instanzpartitionen aus.

4. Klicken Sie in der Liste der Instanzpartitionen in der Spalte Aktionen auf Weitere Aktionen und wählen Sie Bearbeiten aus.

5. Klicken Sie unter Rechenkapazität konfigurieren auf Autoscaling.

6. Wählen Sie für Minimum das Mindestlimit aus, das beim Herunterskalieren verwendet werden soll. Weitere Informationen finden Sie unter Mindestlimit bestimmen.

7. Wählen Sie unter Maximum das maximale Limit für die Hochskalierung aus. Weitere Informationen finden Sie unter Höchstgrenze ermitteln.

8. Geben Sie für CPU-Auslastungsziel mit hoher Priorität den Prozentsatz der CPU ein, der für Aufgaben mit hoher Priorität verwendet werden soll. Weitere Informationen finden Sie unter Ziel für die CPU-Auslastung bestimmen.

9. Geben Sie unter Ziel für gesamte CPU-Auslastung den CPU-Prozentsatz ein, der für alle Aufgaben mit niedriger, mittlerer und hoher Priorität verwendet werden soll. Der CPU-Prozentsatz kann zwischen 10 % und 90 % liegen. Weitere Informationen finden Sie unter Ziel für die gesamte CPU-Auslastung bestimmen.

10. Geben Sie unter Speicherauslastungsziel den Prozentsatz des zu verwendenden Speichers ein. Weitere Informationen finden Sie unter Ziel für die Speicherauslastung festlegen.

11. Klicken Sie auf Speichern.

gcloud

Verwenden Sie den Befehl gcloud spanner instance-partitions update, um das verwaltete Autoscaling für eine Instanzpartition zu aktivieren. Weitere Informationen und Einschränkungen finden Sie unter Google Cloud CLI-Flags und Einschränkungen.

Mit dem folgenden Befehl können Sie den verwalteten Autoscaler hinzufügen:

  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

oder

  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

Ersetzen Sie Folgendes:

• INSTANCE_PARTITION_ID: die permanente Kennung der Instanzpartition.
• INSTANCE_ID: Die permanente Kennzeichnung der Instanz.
• MINIMUM_PROCESSING_UNITS oder MINIMUM_NODES: Die Mindestanzahl an Verarbeitungseinheiten oder Knoten, die beim Herunterskalieren verwendet werden sollen. Weitere Informationen finden Sie unter Mindestlimit bestimmen.
• MAXIMUM_PROCESSING_UNITS oder MAXIMUM_NODES: Die maximale Anzahl von Verarbeitungseinheiten oder Knoten, die beim Hochskalieren verwendet werden sollen. Weitere Informationen finden Sie unter Höchstgrenze bestimmen.
• HIGH_PRIORITY_CPU_PERCENTAGE: der Zielprozentsatz der CPU mit hoher Priorität, der basierend auf der Priorität der Aufgabe verwendet werden soll. Der CPU-Prozentsatz kann zwischen 10 % und 90 % liegen. Weitere Informationen finden Sie unter Ziel für die CPU-Auslastung mit hoher Priorität bestimmen.
• TOTAL_CPU_PERCENTAGE: der Zielprozentsatz der gesamten CPU-Priorität, die verwendet werden soll. Das Ziel für die gesamte CPU-Auslastung muss größer sein als das Ziel für die CPU-Auslastung mit hoher Priorität. Der CPU-Prozentsatz kann zwischen 10 % und 90 % liegen. Weitere Informationen finden Sie unter Ziel für die gesamte CPU-Auslastung bestimmen.
• STORAGE_PERCENTAGE: der Zielprozentsatz des zu verwendenden Speichers, von 10 % bis 99 %. Weitere Informationen finden Sie unter Ziel für die Speicherauslastung bestimmen.

Nachdem Sie den verwalteten Autoscaler für eine Instanzpartition aktiviert haben, können Sie auch die Einstellungen des verwalteten Autoscalers ändern. Wenn Sie beispielsweise die maximale Anzahl von Verarbeitungseinheiten auf 10.000 erhöhen möchten, führen Sie den folgenden Befehl aus:

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

Instanzpartition von verwaltetem Autoscaling auf manuelle Skalierung umstellen

Console

1. Rufen Sie in der Google Cloud Console die Seite Spanner-Instanzen auf.

   Zur Seite "VM-Instanzen"

2. Wählen Sie eine Instanz aus der Liste aus.

3. Wählen Sie im Navigationsmenü Instanzpartitionen aus.

4. Klicken Sie in der Liste der Instanzpartitionen in der Spalte Aktionen auf Weitere Aktionen und wählen Sie Bearbeiten aus.

5. Klicken Sie unter Skalierungsmodus auswählen das Kästchen Manuelle Zuordnung an.

6. Klicken Sie auf Speichern.

gcloud

Verwenden Sie den Befehl gcloud spanner instance-partitions update, um die Instanzpartition zu aktualisieren.

Verwenden Sie den folgenden Befehl, um eine Instanzpartition von der Verwendung des verwalteten Autoscalings auf manuelles Skalieren umzustellen:

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

oder

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

Ersetzen Sie Folgendes:

• INSTANCE_PARTITION_ID: die permanente Kennung der Instanzpartition.
• INSTANCE_ID: Die permanente Kennzeichnung der Instanz.
• NODE_COUNT: die Rechenkapazität der Instanz, ausgedrückt als Anzahl von Knoten. Jeder Knoten entspricht 1.000 Verarbeitungseinheiten.
• PROCESSING_UNIT_COUNT: die Rechenkapazität der Instanz, ausgedrückt als Anzahl von Verarbeitungseinheiten. Die Mindestanzahl von Verarbeitungseinheiten für eine Instanzpartition beträgt 1.000.

Instanzpartition löschen

Sie können eine Instanzpartition nicht löschen, solange sie mit Platzierungen oder Daten verknüpft ist. Sie müssen zuerst alle Daten in der Instanzpartition verschieben oder die Platzierungstabellen löschen, die die Instanzpartition verwenden, bevor Sie die Instanzpartition löschen können.

Console

1. Öffnen Sie in der Google Cloud Console die Seite Spanner.

   Spanner aufrufen

2. Wählen Sie eine Instanz aus der Liste aus.

3. Wählen Sie im Navigationsmenü Instanzpartitionen aus.

4. Klicken Sie in der Liste der Instanzpartitionen in der Spalte Aktionen auf Weitere Aktionen und wählen Sie Löschen aus.

5. Folgen Sie der Anleitung, um zu bestätigen, dass Sie die Instanzpartition löschen möchten.

6. Klicken Sie auf Löschen.

gcloud

Führen Sie den Befehl gcloud spanner instance-partitions delete aus.

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

Nächste Schritte

• Platzierungstabelle und ‑schlüssel erstellen und verwalten