Instanzen erstellen und verwalten

Auf dieser Seite wird beschrieben, wie Spanner-Instanzen erstellt, aufgelistet, bearbeitet und gelöscht werden.

Hinweis: Informationen zum Kennenlernen von Spanner mit einer 90-tägigen kostenlosen Testinstanz finden Sie unter Kostenlose Spanner-Testinstanz erstellen.

Instanz erstellen

Sie können eine Instanz mit der Google Cloud Console, der Google Cloud CLI oder Clientbibliotheken erstellen. Sie können auch eine Instanz mit einer benutzerdefinierten Instanzkonfiguration erstellen, indem Sie optionale schreibgeschützte Replikate hinzufügen.

Hinweis: Sie müssen keinen Speicher in Spanner bereitstellen und Ihnen wird nur der genutzte Speicher in Rechnung gestellt. Weitere Informationen zu Speicherpreisen

Console

1. Rufen Sie in der Google Cloud Console die Seite Instanz erstellen auf.

   Instanz erstellen

2. Geben Sie einen Instanznamen ein, der in der Google Cloud Console angezeigt werden soll. Der Instanzname darf in einem Google Cloud-Projekt nur einmal vorkommen.

3. Geben Sie eine Instanz-ID ein, um die Instanz dauerhaft zu identifizieren. Außerdem muss die Instanz-ID innerhalb Ihres Google Cloud-Projekts eindeutig sein. Sie können die Instanz-ID später nicht ändern.

4. Klicken Sie auf Weiter.

5. Wählen Sie im Bereich Instanz konfigurieren unter Konfiguration auswählen die Option Regional, Dual-Region oder Mehrere Regionen aus. Wenn Sie die Spezifikationen der drei Konfigurationen vergleichen möchten, klicken Sie auf Regionskonfigurationen vergleichen.

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

7. Optional: Wenn Sie einer Spanner-Basiskonfiguration ein schreibgeschütztes Replikat hinzufügen möchten, erstellen Sie zuerst eine benutzerdefinierte Instanzkonfiguration mit der Google Cloud CLI.

8. Klicken Sie auf Weiter.

9. Klicken Sie im Bereich Rechenkapazität zuweisen unter Einheit auswählen auf eine der folgenden Optionen:

   • Verarbeitungseinheiten für kleine Instanzen.
   • Knoten für große Instanzen. Ein Knoten besteht aus 1.000 Verarbeitungseinheiten.

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

10. 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 (Vorabversion), damit Spanner automatisch Rechenkapazität hinzufügen und entfernen kann. Weitere Informationen zum verwalteten verwalteten Autoscaling finden Sie unter Verwaltetes Autoscaling für Spanner. Konfigurieren Sie die folgenden Optionen für das verwaltete Autoscaling:

      • Minimum gibt das Minimallimit an, auf das herunterskaliert werden soll, abhängig von der Maßeinheit, die Sie für Compute-Kapazität ausgewählt haben. Weitere Informationen finden Sie unter Mindestgrenze festlegen.
      • Maximum gibt das Maximum für die Skalierung an, abhängig von der Maßeinheit, die Sie für Rechenkapazität ausgewählt haben. Weitere Informationen finden Sie unter Obergrenze festlegen.
      • CPU-Auslastungsziel mit hoher Priorität gibt den Zielprozentsatz der zu verwendenden CPU mit hoher Priorität an. Weitere Informationen finden Sie unter CPU-Auslastungsziel bestimmen.
      • Speicherauslastungsziel gibt den Zielprozentsatz des zu verwendenden Speichers an. Weitere Informationen finden Sie unter Speicherauslastungsziel bestimmen.

11. Klicken Sie auf Erstellen, um die Instanz zu erstellen.

gcloud

Verwenden Sie den Befehl gcloud spanner instances create, um eine Instanz zu erstellen. Geben Sie unter Rechenkapazität die Anzahl der Knoten oder Verarbeitungseinheiten an, die Sie für die Instanz wünschen.

gcloud spanner instances create INSTANCE-ID \
--config=INSTANCE-CONFIG \
--description=INSTANCE-DESCRIPTION \
--nodes=NODE-COUNT

oder

gcloud spanner instances create INSTANCE-ID \
--config=INSTANCE-CONFIG \
--description=INSTANCE-DESCRIPTION \
--processing-units=PROCESSING-UNIT-COUNT

Ersetzen Sie Folgendes:

• INSTANCE-ID: Eine permanente Kennzeichnung, die in Ihrem Google Cloud-Projekt eindeutig ist. Sie können die Instanz-ID später nicht ändern.
• INSTANCE-CONFIG: Eine permanente Kennzeichnung der Instanzkonfiguration, die den geografischen Standort der Instanz definiert und die Replikation der Daten beeinflusst. Bei benutzerdefinierten Instanzkonfigurationen beginnt sie mit custom-. Weitere Informationen finden Sie unter Instanzkonfigurationen.
• INSTANCE-DESCRIPTION: Der Name, der für die Instanz in der Google Cloud Console angezeigt werden soll. Der Instanzname darf innerhalb eines Google Cloud-Projekts nur einmal vorkommen.

• 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 der Verarbeitungseinheiten. Geben Sie Mengen bis zu 1.000 als Vielfache von 100 (100, 200, 300 usw.) und größere Mengen als Vielfache von 1.000 (1.000, 2.000, 3.000 usw.) ein. Hinweis: Verwenden Sie diesen Parameter nicht, wenn Sie eine Instanz erstellen, die Sie später mit dem verwalteten Autoscaling aktivieren möchten.

Verwaltetes Autoscaling hinzufügen (Vorschau)

Sie können neue Instanzen auch für die Verwendung des verwalteten Autoscalings mit dem Befehl gcloud beta spanner instances create konfigurieren. Weitere Informationen finden Sie unter Verwaltetes Autoscaling für Spanner.

Verwenden Sie den folgenden Befehl, um eine Instanz mit verwaltetem Autoscaling zu erstellen.

  gcloud beta spanner instances create INSTANCE-ID \
    --config=INSTANCE-CONFIG \
    --description=INSTANCE-DESCRIPTION \
    --autoscaling-min-processing-units=MINIMUM_PROCESSING_UNITS \
    --autoscaling-max-processing-units=MAXIMUM_PROCESSING_UNITS \
    --autoscaling-high-priority-cpu-target=CPU_PERCENTAGE \
    --autoscaling-storage-target=STORAGE_PERCENTAGE

oder

  gcloud beta spanner instances create INSTANCE-ID \
    --config=INSTANCE-CONFIG \
    --description=INSTANCE-DESCRIPTION \
    --autoscaling-min-nodes=MINIMUM_NODES \
    --autoscaling-max-nodes=MAXIMUM_NODES \
    --autoscaling-high-priority-cpu-target=CPU_PERCENTAGE \
    --autoscaling-storage-target=STORAGE_PERCENTAGE

Ersetzen Sie Folgendes:

• INSTANCE-ID: Eine permanente Kennzeichnung, die in Ihrem Google Cloud-Projekt eindeutig ist. Sie können die Instanz-ID später nicht ändern.
• INSTANCE-CONFIG: Eine permanente Kennzeichnung der Instanzkonfiguration, die den geografischen Standort der Instanz definiert und die Replikation der Daten beeinflusst. Bei benutzerdefinierten Instanzkonfigurationen beginnt sie mit custom-. Weitere Informationen finden Sie unter Instanzkonfigurationen.
• INSTANCE-DESCRIPTION: Der Name, der für die Instanz in der Google Cloud Console angezeigt werden soll. Der Instanzname darf innerhalb eines Google Cloud-Projekts nur einmal vorkommen.
• MINIMUM_PROCESSING_UNITS, MINIMUM_NODES: die Mindestanzahl von Verarbeitungseinheiten oder Knoten beim Herunterskalieren. Weitere Informationen finden Sie unter Mindestgrenze festlegen.
• MAXIMUM_PROCESSING_UNITS, MAXIMUM_NODES: die maximale Anzahl von Verarbeitungseinheiten oder Knoten beim Hochskalieren. Weitere Informationen finden Sie unter Höchstgrenze festlegen.
• CPU_PERCENTAGE: Der Zielprozentsatz der zu verwendenden CPU mit hoher Priorität (10 bis 90 %). Wenn Sie die Kosten optimieren, verwenden Sie einen höheren Prozentsatz. Weitere Informationen finden Sie unter CPU-Auslastungsziel bestimmen.
• STORAGE_PERCENTAGE: Der Zielprozentsatz des zu verwendenden Speichers (von 10 bis 99 %). Weitere Informationen finden Sie unter Speicherauslastungsziel bestimmen.

Beispiele für die Verwendung benutzerdefinierter Konfigurationen

Führen Sie folgenden Befehl aus, um die Instanz test-instance in der regionalen Basisinstanzkonfiguration us-central1 zu erstellen:

gcloud spanner instances create test-instance --config=regional-us-central1 \
  --description="Test Instance" --nodes=1

Zum Erstellen der Instanz custom-eur6-instance in der benutzerdefinierten multiregionalen Instanzkonfiguration custom-eur6 müssen Sie zuerst eine benutzerdefinierte Instanzkonfiguration erstellen.

Führen Sie dann diesen Befehl aus:

  gcloud spanner instances create custom-eur6-instance --config=custom-eur6 \
      --description="Instance with custom read-only" --nodes=1

Nachdem Sie einen der vorherigen Befehle ausgeführt haben, sollten Sie eine Meldung ähnlich dem folgenden Beispiel sehen:

Creating instance...done.

C++

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

Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Spanner zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.

void CreateInstance(google::cloud::spanner_admin::InstanceAdminClient client,
                    std::string const& project_id,
                    std::string const& instance_id,
                    std::string const& display_name,
                    std::string const& config_id) {
  namespace spanner = ::google::cloud::spanner;
  spanner::Instance in(project_id, instance_id);

  auto project = google::cloud::Project(project_id);
  std::string config_name =
      project.FullName() + "/instanceConfigs/" + config_id;
  auto instance =
      client
          .CreateInstance(spanner::CreateInstanceRequestBuilder(in, config_name)
                              .SetDisplayName(display_name)
                              .SetNodeCount(1)
                              .SetLabels({{"cloud_spanner_samples", "true"}})
                              .Build())
          .get();
  if (!instance) throw std::move(instance).status();
  std::cout << "Created instance [" << in << "]:\n" << instance->DebugString();
}

C#

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

Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Spanner zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.

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

public class CreateInstanceSample
{
    public Instance CreateInstance(string projectId, string instanceId)
    {
        // Create the InstanceAdminClient instance.
        InstanceAdminClient instanceAdminClient = InstanceAdminClient.Create();

        // Initialize request parameters.
        Instance instance = new Instance
        {
            InstanceName = InstanceName.FromProjectInstance(projectId, instanceId),
            ConfigAsInstanceConfigName = InstanceConfigName.FromProjectInstanceConfig(projectId, "regional-us-central1"),
            DisplayName = "This is a display name.",
            NodeCount = 1,
            Labels =
            {
                { "cloud_spanner_samples", "true" },
            }
        };
        ProjectName projectName = ProjectName.FromProject(projectId);

        // Make the CreateInstance request.
        Operation<Instance, CreateInstanceMetadata> response = instanceAdminClient.CreateInstance(projectName, instanceId, instance);

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

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

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

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

        return completedResponse.Result;
    }
}

Einfach loslegen (Go)

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

Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Spanner zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.

import (
	"context"
	"fmt"
	"io"

	instance "cloud.google.com/go/spanner/admin/instance/apiv1"
	instancepb "google.golang.org/genproto/googleapis/spanner/admin/instance/v1"
)

func createInstance(w io.Writer, projectID, instanceID string) error {
	// projectID := "my-project-id"
	// instanceID := "my-instance"
	ctx := context.Background()
	instanceAdmin, err := instance.NewInstanceAdminClient(ctx)
	if err != nil {
		return err
	}
	defer instanceAdmin.Close()

	op, err := instanceAdmin.CreateInstance(ctx, &instancepb.CreateInstanceRequest{
		Parent:     fmt.Sprintf("projects/%s", projectID),
		InstanceId: instanceID,
		Instance: &instancepb.Instance{
			Config:      fmt.Sprintf("projects/%s/instanceConfigs/%s", projectID, "regional-us-central1"),
			DisplayName: instanceID,
			NodeCount:   1,
			Labels:      map[string]string{"cloud_spanner_samples": "true"},
		},
	})
	if err != nil {
		return fmt.Errorf("could not create instance %s: %w", fmt.Sprintf("projects/%s/instances/%s", projectID, instanceID), err)
	}
	// Wait for the instance creation to finish.
	i, err := op.Wait(ctx)
	if err != nil {
		return fmt.Errorf("waiting for instance creation to finish failed: %w", err)
	}
	// The instance may not be ready to serve yet.
	if i.State != instancepb.Instance_READY {
		fmt.Fprintf(w, "instance state is not READY yet. Got state %v\n", i.State)
	}
	fmt.Fprintf(w, "Created instance [%s]\n", instanceID)
	return nil
}

Instanz mit verwaltetem Autoscaling mithilfe von Go erstellen (Vorschau)

import (
	"context"
	"fmt"
	"io"

	instance "cloud.google.com/go/spanner/admin/instance/apiv1"
	"cloud.google.com/go/spanner/admin/instance/apiv1/instancepb"
	"google.golang.org/genproto/protobuf/field_mask"
)

// Example of creating an autoscaling instance with Go.
// projectID is the ID of the project that the new instance will be in.
// instanceID is the ID of the new instance to be created.
func createInstanceWithAutoscalingConfig(w io.Writer, projectID, instanceID string) error {
	// projectID := "my-project-id"
	// instanceID := "my-instance"
	ctx := context.Background()
	instanceAdmin, err := instance.NewInstanceAdminClient(ctx)
	if err != nil {
		return fmt.Errorf("could not create instance admin client for project %s: %w", projectID, err)
	}
	defer instanceAdmin.Close()

	instanceName := fmt.Sprintf("projects/%s/instances/%s", projectID, instanceID)
	fmt.Fprintf(w, "Creating instance %s.", instanceName)

	op, err := instanceAdmin.CreateInstance(ctx, &instancepb.CreateInstanceRequest{
		Parent:     fmt.Sprintf("projects/%s", projectID),
		InstanceId: instanceID,
		Instance: &instancepb.Instance{
			Config:      fmt.Sprintf("projects/%s/instanceConfigs/%s", projectID, "regional-us-central1"),
			DisplayName: "Create instance example",
			AutoscalingConfig: &instancepb.AutoscalingConfig{
				AutoscalingLimits: &instancepb.AutoscalingConfig_AutoscalingLimits{
					MinLimit: &instancepb.AutoscalingConfig_AutoscalingLimits_MinNodes{
						MinNodes: 1,
					},
					MaxLimit: &instancepb.AutoscalingConfig_AutoscalingLimits_MaxNodes{
						MaxNodes: 2,
					},
				},
				AutoscalingTargets: &instancepb.AutoscalingConfig_AutoscalingTargets{
					HighPriorityCpuUtilizationPercent: 65,
					StorageUtilizationPercent:         95,
				},
			},
			Labels: map[string]string{"cloud_spanner_samples": "true"},
		},
	})
	if err != nil {
		return fmt.Errorf("could not create instance %s: %w", instanceName, err)
	}
	fmt.Fprintf(w, "Waiting for operation on %s to complete...", instanceID)
	// Wait for the instance creation to finish.
	i, err := op.Wait(ctx)
	if err != nil {
		return fmt.Errorf("waiting for instance creation to finish failed: %w", err)
	}
	// The instance may not be ready to serve yet.
	if i.State != instancepb.Instance_READY {
		fmt.Fprintf(w, "instance state is not READY yet. Got state %v\n", i.State)
	}
	fmt.Fprintf(w, "Created instance [%s].\n", instanceID)

	instance, err := instanceAdmin.GetInstance(ctx, &instancepb.GetInstanceRequest{
		Name: instanceName,
		// Get the autoscaling_config field from the newly created instance.
		FieldMask: &field_mask.FieldMask{Paths: []string{"autoscaling_config"}},
	})
	if err != nil {
		return fmt.Errorf("failed to get instance [%s]: %w", instanceName, err)
	}
	fmt.Fprintf(w, "Instance %s has autoscaling_config: %s.", instanceID, instance.AutoscalingConfig)
	return nil
}

Java

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

Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Spanner zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.

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.CreateInstanceRequest;
import com.google.spanner.admin.instance.v1.Instance;
import com.google.spanner.admin.instance.v1.InstanceConfigName;
import com.google.spanner.admin.instance.v1.ProjectName;
import java.util.concurrent.ExecutionException;

class CreateInstanceExample {

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

  static void createInstance(String projectId, String instanceId) {
    // Set Instance configuration.
    int nodeCount = 2;
    String displayName = "Descriptive name";

    // Create an Instance object that will be used to create the instance.
    Instance instance =
        Instance.newBuilder()
            .setDisplayName(displayName)
            .setNodeCount(nodeCount)
            .setConfig(
                InstanceConfigName.of(projectId, "regional-us-central1").toString())
            .build();

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

      // Wait for the createInstance operation to finish.
      Instance createdInstance = instanceAdminClient.createInstanceAsync(
          CreateInstanceRequest.newBuilder()
              .setParent(ProjectName.of(projectId).toString())
              .setInstanceId(instanceId)
              .setInstance(instance)
              .build()).get();
      System.out.printf("Instance %s was successfully created%n", createdInstance.getName());
    } catch (ExecutionException e) {
      System.out.printf(
          "Error: Creating instance %s failed with error message %s%n",
          instance.getName(), e.getMessage());
    } catch (InterruptedException e) {
      System.out.println("Error: Waiting for createInstance operation to finish was interrupted");
    }
  }
}

Hinweis: Die Codebeispiele für die alte Clientbibliothek-Schnittstelle für Java sind in GitHub archiviert.

Instanz mit verwaltetem Autoscaling mit Java erstellen (Vorschau)

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.AutoscalingConfig;
import com.google.spanner.admin.instance.v1.CreateInstanceRequest;
import com.google.spanner.admin.instance.v1.Instance;
import com.google.spanner.admin.instance.v1.InstanceConfigName;
import com.google.spanner.admin.instance.v1.ProjectName;
import java.util.concurrent.ExecutionException;

class CreateInstanceWithAutoscalingConfigExample {

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

  static void createInstance(String projectId, String instanceId) {
    try (Spanner spanner =
        SpannerOptions.newBuilder()
            .setProjectId(projectId)
            .build()
            .getService();
        InstanceAdminClient instanceAdminClient = spanner.createInstanceAdminClient()) {
      // Set Instance configuration.
      String configId = "regional-us-central1";
      String displayName = "Descriptive name";

      // Create an autoscaling config.
      // When autoscaling_config is enabled, node_count and processing_units fields
      // need not be specified.
      AutoscalingConfig autoscalingConfig =
          AutoscalingConfig.newBuilder()
              .setAutoscalingLimits(
                  AutoscalingConfig.AutoscalingLimits.newBuilder().setMinNodes(1).setMaxNodes(2))
              .setAutoscalingTargets(
                  AutoscalingConfig.AutoscalingTargets.newBuilder()
                      .setHighPriorityCpuUtilizationPercent(65)
                      .setStorageUtilizationPercent(95))
              .build();
      Instance instance =
          Instance.newBuilder()
              .setAutoscalingConfig(autoscalingConfig)
              .setDisplayName(displayName)
              .setConfig(
                  InstanceConfigName.of(projectId, configId).toString())
              .build();

      // Creates a new instance
      System.out.printf("Creating instance %s.%n", instanceId);
      try {
        // Wait for the createInstance operation to finish.
        Instance instanceResult = instanceAdminClient.createInstanceAsync(
            CreateInstanceRequest.newBuilder()
                .setParent(ProjectName.of(projectId).toString())
                .setInstanceId(instanceId)
                .setInstance(instance)
                .build()).get();
        System.out.printf("Autoscaler instance %s was successfully created%n",
            instanceResult.getName());
      } catch (ExecutionException e) {
        System.out.printf(
            "Error: Creating instance %s failed with error message %s%n",
            instance.getName(), e.getMessage());
      } catch (InterruptedException e) {
        System.out.println("Error: Waiting for createInstance operation to finish was interrupted");
      }
    }
  }
}

Node.js

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

Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Spanner zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.

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

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

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

// Creates a new instance
try {
  console.log(
    `Creating instance ${instanceAdminClient.instancePath(
      projectId,
      instanceId
    )}.`
  );
  const [operation] = await instanceAdminClient.createInstance({
    instanceId: instanceId,
    parent: instanceAdminClient.projectPath(projectId),
    instance: {
      config: instanceAdminClient.instanceConfigPath(
        projectId,
        'regional-us-central1'
      ),
      nodeCount: 1,
      displayName: 'Display name for the instance.',
      labels: {
        cloud_spanner_samples: 'true',
        created: Math.round(Date.now() / 1000).toString(), // current time
      },
    },
  });

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

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

Hinweis: Die Codebeispiele für Node.js der alten Clientbibliothek-Schnittstelle sind in GitHub archiviert.

PHP

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

Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Spanner zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.

use Google\Cloud\Spanner\Admin\Instance\V1\Client\InstanceAdminClient;
use Google\Cloud\Spanner\Admin\Instance\V1\CreateInstanceRequest;
use Google\Cloud\Spanner\Admin\Instance\V1\Instance;

/**
 * Creates an instance.
 * Example:
 * ```
 * create_instance($projectId, $instanceId);
 * ```
 *
 * @param string $projectId  The Spanner project ID.
 * @param string $instanceId The Spanner instance ID.
 */
function create_instance(string $projectId, string $instanceId): void
{
    $instanceAdminClient = new InstanceAdminClient();
    $parent = InstanceAdminClient::projectName($projectId);
    $instanceName = InstanceAdminClient::instanceName($projectId, $instanceId);
    $configName = $instanceAdminClient->instanceConfigName($projectId, 'regional-us-central1');
    $instance = (new Instance())
        ->setName($instanceName)
        ->setConfig($configName)
        ->setDisplayName('dispName')
        ->setNodeCount(1);

    $operation = $instanceAdminClient->createInstance(
        (new CreateInstanceRequest())
        ->setParent($parent)
        ->setInstanceId($instanceId)
        ->setInstance($instance)
    );

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

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

Hinweis: Die alten Codebeispiele für die Clientbibliothek-Schnittstelle für PHP sind in GitHub archiviert.

Python

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

Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Spanner zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.

def create_instance(instance_id):
    """Creates an instance."""
    from google.cloud.spanner_admin_instance_v1.types import \
        spanner_instance_admin

    spanner_client = spanner.Client()

    config_name = "{}/instanceConfigs/regional-us-central1".format(
        spanner_client.project_name
    )

    operation = spanner_client.instance_admin_api.create_instance(
        parent=spanner_client.project_name,
        instance_id=instance_id,
        instance=spanner_instance_admin.Instance(
            config=config_name,
            display_name="This is a display name.",
            node_count=1,
            labels={
                "cloud_spanner_samples": "true",
                "sample_name": "snippets-create_instance-explicit",
                "created": str(int(time.time())),
            },
        ),
    )

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

    print("Created instance {}".format(instance_id))

Hinweis: Die Codebeispiele für Python der alten Clientbibliothek-Schnittstelle sind in GitHub archiviert.

Ruby

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

Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Spanner zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.

# project_id  = "Your Google Cloud project ID"
# instance_id = "Your Spanner instance ID"

require "google/cloud/spanner"
require "google/cloud/spanner/admin/instance"

instance_admin_client = Google::Cloud::Spanner::Admin::Instance.instance_admin

project_path = instance_admin_client.project_path project: project_id
instance_path = instance_admin_client.instance_path project: project_id, instance: instance_id
instance_config_path = instance_admin_client.instance_config_path project: project_id, instance_config: "regional-us-central1"

job = instance_admin_client.create_instance parent: project_path,
                                            instance_id: instance_id,
                                            instance: { name: instance_path,
                                                        config: instance_config_path,
                                                        display_name: instance_id,
                                                        node_count: 2,
                                                        labels: { cloud_spanner_samples: "true" } }

puts "Waiting for create instance operation to complete"

job.wait_until_done!

if job.error?
  puts job.error
else
  puts "Created instance #{instance_id}"
end

Instanzen auflisten

Sie können eine Liste Ihrer Spanner-Instanzen aufrufen.

Console

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

Zur Seite "VM-Instanzen"

Die Google Cloud Console zeigt eine Liste Ihrer Spanner-Instanzen zusammen mit der ID jeder Instanz, dem Anzeigenamen, der Konfiguration und der Rechenkapazität, sowohl in Verarbeitungseinheiten als auch in Knoten.

gcloud

Führen Sie den Befehl gcloud spanner instances list aus:

gcloud spanner instances list

Die gcloud CLI gibt eine Liste Ihrer Spanner-Instanzen zusammen mit der ID jeder Instanz, dem Anzeigenamen, der Konfiguration und der Rechenkapazität aus.

Instanz bearbeiten

In den folgenden Abschnitten wird erläutert, wie Sie den Anzeigenamen und die Rechenkapazität einer Instanz ändern. Sie können die Instanz-ID oder die Instanzkonfiguration nicht ändern.

Anzeigenamen ändern

Console

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

   Zur Seite "VM-Instanzen"

2. Klicken Sie auf den Namen der Instanz, die Sie umbenennen möchten.

3. Klicken Sie auf Instanz bearbeiten.

4. Geben Sie einen neuen Instanznamen ein. Dieser Name darf im Google Cloud-Projekt nur einmal vorkommen.

5. Klicken Sie auf Speichern.

gcloud

Führen Sie den Befehl gcloud spanner instances update aus:

gcloud spanner instances update INSTANCE_ID --description=INSTANCE_NAME

Ersetzen Sie Folgendes:

• INSTANCE_ID: Die permanente Kennzeichnung der Instanz.
• INSTANCE_NAME: Der Name, der für die Instanz in der Google Cloud Console angezeigt werden soll. Der Instanzname darf innerhalb eines Google Cloud-Projekts nur einmal vorkommen.

Rechenkapazität ändern

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

Es gibt einige Fälle, in denen Sie die Rechenkapazität einer vorhandenen Instanz nicht reduzieren können:

• Zum Entfernen von Rechenkapazität müsste Ihre Instanz mehr als 4 TB Daten pro 1.000 Verarbeitungseinheiten (1 Knoten) speichern.
• Basierend auf Ihren bisherigen Nutzungsmustern hat Spanner eine große Anzahl von Splits für die Daten Ihrer Instanz erstellt. In seltenen Fällen kann Spanner die Splits dann nach dem Entfernen von Rechenkapazität nicht mehr verwalten.

Im letzteren Fall könnten Sie versuchen, die Rechenkapazität schrittweise um immer kleinere Beträge zu reduzieren, bis Sie die Mindestkapazität gefunden haben, die Spanner zur Verwaltung aller Splits der Instanz benötigt. Wenn die Instanz aufgrund einer Änderung der Nutzungsmuster nicht mehr so viele Splits benötigt, kann Spanner einige Splits letztendlich zusammenführen. Sie können dann nach ein bis zwei Wochen versuchen, die Rechenkapazität der Instanz weiter zu reduzieren.

Überwachen Sie beim Entfernen von Rechenkapazität die CPU-Auslastung und die Anfragelatenzen in Cloud Monitoring, damit die CPU-Auslastung für regionale Instanzen unter 65% und in multiregionalen Instanzen unter 45% bleibt. Unter Umständen kann es zu einem vorübergehenden Anstieg der Anfragelatenzen kommen, während Sie Rechenkapazität entfernen.

Wenn Sie die Rechenkapazität einer Instanz erhöhen möchten, muss Ihr Google Cloud-Projekt über ein ausreichendes Kontingent zum Hinzufügen der Rechenkapazität verfügen. Wie lange es dauert, bis die Erhöhungsanfrage 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. Rufen Sie in der Google Cloud Console die Seite Spanner-Instanzen auf.

   Zur Seite "VM-Instanzen"

2. Klicken Sie auf den Namen der Instanz, die Sie ändern möchten.

3. Klicken Sie auf Instanz bearbeiten.

4. Ändern Sie die Rechenkapazität, indem Sie die Maßeinheiten (Verarbeitungseinheiten oder Knoten) auswählen und dann eine Menge eingeben. Geben Sie bei Verwendung von Verarbeitungseinheiten Mengen bis zu 1.000 in Vielfachen von 100 (100, 200, 300 usw.) und größere Mengen als Vielfache von 1.000 (1.000, 2.000, 3.000 usw.) ein. Jeder Knoten entspricht 1.000 Verarbeitungseinheiten.

5. Klicken Sie auf Speichern.

Wenn in einem Dialogfeld angezeigt wird, dass Sie kein ausreichendes Kontingent haben, um Rechenkapazität an dieser Position hinzuzufügen, folgen Sie den Anweisungen, um ein höheres Kontingent anzufordern.

gcloud

Führen Sie den Befehl gcloud spanner instances update aus. Geben Sie bei Verwendung dieses Befehls die Rechenkapazität als Anzahl der Knoten oder Verarbeitungseinheiten an.

gcloud spanner instances update INSTANCE_ID --nodes=NODE_COUNT
[--async]

oder

gcloud spanner instances update INSTANCE_ID
--processing-units=PROCESSING_UNIT_COUNT [--async]

Ersetzen Sie Folgendes:

• 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 der Verarbeitungseinheiten. Geben Sie Mengen bis zu 1.000 als Vielfache von 100 (100, 200, 300 usw.) und größere Mengen als Vielfache von 1.000 (1.000, 2.000, 3.000 usw.) ein.

Optionale Flags:

• --async: Verwenden Sie dieses Flag, wenn Ihre Anfrage sofort zurückgegeben werden soll, ohne auf den Abschluss des Vorgangs zu warten. Sie können den Status Ihrer Anfrage mit dem Befehl gcloud spanner operations describe prüfen.

Verwaltetes Autoscaling für eine Instanz aktivieren oder ändern

Vorschau — Managed autoscaler

Diese Funktion unterliegt den „Nutzungsbedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Nutzungsbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Funktionen sind „wie besehen“ verfügbar und werden möglicherweise nur eingeschränkt unterstützt. Weitere Informationen finden Sie in den Beschreibungen der Startphase.

Die folgenden Einschränkungen gelten, wenn Sie die verwaltete Autoscaling-Funktion in einer vorhandenen Instanz hinzufügen oder ändern:

• Sie können das verwaltete Autoscaling für eine Instanz, die Sie verschieben, nicht aktivieren.

• Sie können keine Instanz verschieben, während das verwaltete Autoscaling aktiviert ist.

Console

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

   Zur Seite "VM-Instanzen"

2. Klicken Sie auf den Namen der Instanz, für die Sie das verwaltete Autoscaling aktivieren möchten.

3. Klicken Sie auf Instanz bearbeiten.

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

5. Wählen Sie als Minimum das Mindestlimit aus, das beim Herunterskalieren verwendet werden soll. Weitere Informationen finden Sie unter Mindestgrenze festlegen.

6. Wählen Sie als Maximum das Maximum aus, das beim Hochskalieren verwendet werden soll. Weitere Informationen finden Sie unter Obergrenze festlegen.

7. Wählen Sie unter CPU-Auslastungsziel mit hoher Priorität den Prozentsatz der zu verwendenden CPU mit hoher Priorität aus. Weitere Informationen finden Sie unter CPU-Auslastungsziel bestimmen.

8. Wählen Sie unter Speicherauslastungsziel den Prozentsatz des zu verwendenden Speichers aus. Weitere Informationen finden Sie unter Speicherauslastungsziel bestimmen.

9. Klicken Sie auf Speichern.

gcloud

Verwenden Sie den Befehl gcloud beta spanner instances update, um das verwaltete Autoscaling einer Instanz hinzuzufügen. Weitere Informationen und Einschränkungen finden Sie unter Google Cloud CLI-Flags und Einschränkungen.

Sie können das verwaltete Autoscaling mit dem folgenden Befehl hinzufügen:

  gcloud beta spanner instances update INSTANCE_ID \
    --autoscaling-min-processing-units=MINIMUM_PROCESSING_UNITS \
    --autoscaling-max-processing-units=MAXIMUM_PROCESSING_UNITS \
    --autoscaling-high-priority-cpu-target=CPU_PERCENTAGE \
    --autoscaling-storage-target=STORAGE_PERCENTAGE

oder

  gcloud beta spanner instances update INSTANCE_ID \
    --autoscaling-min-processing-units=MINIMUM_NODES \
    --autoscaling-max-processing-units=MAXIMUM_NODES \
    --autoscaling-high-priority-cpu-target=CPU_PERCENTAGE \
    --autoscaling-storage-target=STORAGE_PERCENTAGE

Ersetzen Sie Folgendes:

• INSTANCE_ID: Die permanente Kennzeichnung der Instanz.
• MINIMUM_PROCESSING_UNITS, MINIMUM_NODES: die Mindestanzahl von Verarbeitungseinheiten oder Knoten, die beim Herunterskalieren verwendet werden sollen. Weitere Informationen finden Sie unter Mindestgrenze festlegen.
• MAXIMUM_PROCESSING_UNITS, MAXIMUM_NODES: die maximale Anzahl von Verarbeitungseinheiten oder Knoten, die beim Hochskalieren verwendet werden sollen. Weitere Informationen finden Sie unter Obergrenze festlegen.
• CPU_PERCENTAGE: Der Zielprozentsatz der zu verwendenden CPU mit hoher Priorität (10% bis 90 %). Wenn Sie im Hinblick auf Kosten optimieren und keine niedrige Latenz für alle Anfragen benötigen, verwenden Sie einen höheren Prozentsatz. Weitere Informationen finden Sie unter CPU-Auslastungsziel bestimmen.
• STORAGE_PERCENTAGE: der Zielprozentsatz des zu verwendenden Speichers (von 10% bis 99 %). Weitere Informationen finden Sie unter Speicherauslastungsziel bestimmen.

Nachdem Sie das verwaltete Autoscaling einer Instanz hinzugefügt haben, können Sie auch die verwalteten Autoscaling-Einstellungen ändern. Wenn Sie beispielsweise die maximale Anzahl der Verarbeitungseinheiten auf 10.000 erhöhen möchten, führen Sie den folgenden Befehl aus:

gcloud beta spanner instances update test-instance \
     --autoscaling-max-processing-units=10000

Instanz von verwaltetem Autoscaling auf manuelle Skalierung umstellen

Vorschau — Managed autoscaling

Diese Funktion unterliegt den „Nutzungsbedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Nutzungsbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Funktionen sind „wie besehen“ verfügbar und werden möglicherweise nur eingeschränkt unterstützt. Weitere Informationen finden Sie in den Beschreibungen der Startphase.

Console

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

   Zur Seite "VM-Instanzen"

2. Klicken Sie auf den Namen der Instanz, für die Sie das verwaltete Autoscaling deaktivieren möchten.

3. Klicken Sie unter Skalierungsmodus auswählen auf Manuelle Zuweisung.

4. Klicken Sie auf Speichern.

gcloud

Verwenden Sie den Befehl gcloud beta spanner instances update, um die Instanz zu aktualisieren.

Verwenden Sie den folgenden Befehl, um eine Instanz vom verwalteten Autoscaling auf die manuelle Skalierung umzustellen:

  gcloud beta spanner instances update INSTANCE_ID \
  --processing-units=PROCESSING_UNIT_COUNT

oder

  gcloud beta spanner instances update INSTANCE_ID \
  --nodes=NODE_COUNT

Ersetzen Sie Folgendes:

• 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 der Verarbeitungseinheiten. Geben Sie Mengen bis zu 1.000 als Vielfache von 100 (100, 200, 300 usw.) und größere Mengen als Vielfache von 1.000 (1.000, 2.000, 3.000 usw.) ein.

Instanz mit Labels versehen

Labels erleichtern die Organisation von Ressourcen.

Console

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

   Zur Seite "VM-Instanzen"

2. Klicken Sie auf das Kästchen der Instanz. Das Infofeld wird rechts auf der Seite angezeigt.

3. Klicken Sie im Infofeld auf den Tab Labels. Anschließend können Sie Labels für die Spanner-Instanz hinzufügen, löschen oder aktualisieren.

Instanz verschieben

Hinweis: Sie können keine Instanz verschieben, für die das verwaltete Autoscaling aktiviert ist.

Eine Anleitung zum Verschieben Ihrer Instanz von einer beliebigen Instanzkonfiguration in eine andere Instanzkonfiguration, auch zwischen regionalen und multiregionalen Konfigurationen, finden Sie unter Instanz verschieben.

Instanz löschen

Achtung: Durch das Löschen einer Instanz werden die Instanz und alle zugehörigen Datenbanken endgültig entfernt. Sie können diese Aktion nicht rückgängig machen. Außerdem können Sie keine weitere kostenlose Testinstanz erstellen, nachdem Sie Ihre erste kostenlose Testinstanz gelöscht haben. Sie können eine kostenlose Testinstanz pro Projektlebenszyklus erstellen.

Sie können eine Instanz mit der Google Cloud Console oder der Google Cloud CLI löschen.

Wenn Sie eine Instanz mit einer oder mehreren Datenbanken mit aktiviertem Löschschutz löschen möchten, müssen Sie zuerst den Löschschutz für alle Datenbanken in dieser Instanz deaktivieren. Erst dann können Sie die Instanz löschen.

Console

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

   Zur Seite "VM-Instanzen"

2. Klicken Sie auf den Namen der Instanz, die Sie löschen möchten.

3. Klicken Sie auf Instanz löschen.

4. Folgen Sie den Anweisungen, um zu bestätigen, dass Sie die Instanz löschen möchten.

5. Klicken Sie auf Löschen.

gcloud

Verwenden Sie den Befehl gcloud spanner instances delete. Ersetzen Sie dabei INSTANCE-ID durch die Instanz-ID:

gcloud spanner instances delete INSTANCE-ID

Instanz beenden oder neu starten

Spanner ist ein vollständig verwalteter Datenbankdienst, der die eigenen zugrunde liegenden Aufgaben und Ressourcen überwacht, einschließlich Monitoring und Neustart von Prozessen bei Bedarf ohne Ausfallzeiten. Da eine bestimmte Instanz nicht manuell beendet oder neu gestartet werden muss, bietet Spanner keine Möglichkeit dazu.

Nächste Schritte

• Informationen zum Einfügen, Aktualisieren und Löschen von Daten mit der Datenbearbeitungssprache (DML) oder der gcloud CLI
• Weisen Sie der Instanz und ihren Datenbanken Identity and Access Management-Rollen zu.
• Informieren Sie sich darüber, wie Sie ein Spanner-Schema entwerfen.