Instanzen erstellen und verwalten

Konsole

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

2. Klicken Sie auf Instanz erstellen.

   Zur Seite „Instanz erstellen”

3. Wählen Sie im Abschnitt Version auswählen eine Spanner-Version aus.

   Wenn Sie die Spezifikationen der verschiedenen Versionen vergleichen möchten, klicken Sie auf Versionen vergleichen. Weitere Informationen finden Sie in der Übersicht über Spanner-Editionen.

4. Klicken Sie auf Weiter.

5. Geben Sie im Abschnitt Instanz benennen einen Instanznamen ein, der in der Google Cloud Console angezeigt werden soll. Der Instanzname darf innerhalb Ihres Google Cloud Projekts nur einmal vorkommen.

6. Geben Sie eine Instanz-ID ein, um Ihre Instanz dauerhaft zu identifizieren. Die Instanz-ID darf im Google Cloud -Projekt ebenfalls nur einmal vorkommen. Sie können die Instanz-ID später nicht mehr ändern.

7. Klicken Sie auf Weiter.

8. Wählen Sie im Bereich Instanz konfigurieren unter Konfiguration auswählen die Option Regional, Dual-Region oder Multi-Region aus.

9. Wählen Sie im Drop-down-Menü einen Konfigurationsort aus.

10. 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. Das Hinzufügen optionaler schreibgeschützter Replikate zu einer Basiskonfiguration ist in der Enterprise- und Enterprise Plus-Version verfügbar.

11. Klicken Sie auf Weiter.

12. Klicken Sie im Bereich Rechenkapazität zuweisen 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 Instanzen.

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

13. 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. Der verwaltete Autoscaler ist in der Spanner Enterprise- und Enterprise Plus-Version verfügbar. Weitere Informationen zum verwalteten Autoscaler finden Sie unter Verwalteter Autoscaler für Spanner. Konfigurieren Sie die folgenden Optionen für den verwalteten Autoscaler:

      • Minimum gibt das Mindestlimit für das Herunterskalieren an, je nach der Maßeinheit, die Sie für Compute-Kapazität auswählen. Weitere Informationen finden Sie unter Mindestlimit festlegen.
      • Maximum gibt das maximale Limit für die Aufskalierung an, je nach der Maßeinheit, die Sie für Compute capacity (Rechenkapazität) auswählen. Weitere Informationen finden Sie unter Maximales Limit ermitteln.
      • CPU-Auslastungsziel mit hoher Priorität gibt den Zielprozentsatz der CPU mit hoher Priorität an, der verwendet werden soll. Weitere Informationen finden Sie unter CPU-Auslastungsziel bestimmen.
      • Das Speicherauslastungsziel gibt den Zielprozentsatz des zu verwendenden Speichers an. Weitere Informationen finden Sie unter Ziel für die Speicherauslastung festlegen.

14. Optional: Wenn Sie Autoscaling als Skalierungsmodus auswählen, können Sie auf das Drop-down-Menü Optionen für asymmetrisches Autoscaling einblenden klicken, um Ihre Nur-Lese-Replikate unabhängig von anderen Replikaten automatisch zu skalieren. Weitere Informationen finden Sie unter Asymmetrisches schreibgeschütztes Autoscaling.

    1. Wählen Sie das schreibgeschützte Replikat aus, das Sie asymmetrisch automatisch skalieren möchten.

    2. Konfigurieren Sie die folgenden Optionen für asymmetrisches Autoscaling:

       • Minimum gibt das Mindestlimit für das Herunterskalieren an, je nach der Maßeinheit, die Sie für Compute-Kapazität auswählen. Weitere Informationen finden Sie unter Mindestlimit festlegen.
       • Maximum gibt das maximale Limit für die Aufskalierung an, je nach der Maßeinheit, die Sie für Compute capacity (Rechenkapazität) auswählen. Weitere Informationen finden Sie unter Maximales Limit ermitteln.
       • CPU-Auslastungsziel mit hoher Priorität gibt den Zielprozentsatz der CPU mit hoher Priorität an, der verwendet werden soll. Weitere Informationen finden Sie unter CPU-Auslastungsziel bestimmen.

15. Unter Sicherungen ist das Kästchen Standard-Sicherungszeitpläne aktivieren standardmäßig aktiviert. Wenn Sie Standard-Sicherungszeitpläne deaktivieren möchten, entfernen Sie das Häkchen aus dem Kästchen. Wenn diese Option aktiviert ist, werden für alle neuen Datenbanken in der Instanz alle 24 Stunden Vollsicherungen erstellt. Diese Sicherungen werden 7 Tage lang aufbewahrt. Sie können die Standard-Sicherungszeitpläne jederzeit bearbeiten oder löschen. Weitere Informationen finden Sie unter Standardmäßige Sicherungszeitpläne.

16. 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 die Rechenkapazität als Anzahl der Knoten oder Verarbeitungseinheiten an, die Sie für die Instanz benötigen.

gcloud spanner instances create INSTANCE_ID \
--edition=EDITION \
--config=INSTANCE_CONFIG \
--description=INSTANCE_DESCRIPTION \
--default-backup-schedule-type=DEFAULT_BACKUP_SCHEDULE_TYPE \
--nodes=NODE_COUNT

oder

gcloud spanner instances create INSTANCE_ID \
--edition=EDITION \
--config=INSTANCE_CONFIG \
--description=INSTANCE_DESCRIPTION \
--default-backup-schedule-type=DEFAULT_BACKUP_SCHEDULE_TYPE \
--processing-units=PROCESSING_UNIT_COUNT

Ersetzen Sie Folgendes:

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

• DEFAULT_BACKUP_SCHEDULE_TYPE: Der Standardtyp für den Sicherungszeitplan, der in der Instanz verwendet wird. Dies muss einer der folgenden Werte sein:

  • AUTOMATIC: Wenn eine neue Datenbank in der Instanz erstellt wird, wird automatisch ein Standard-Sicherungszeitplan erstellt. Mit dem Standard-Sicherungszeitplan wird alle 24 Stunden eine Vollsicherung erstellt. Diese vollständigen Sicherungen werden 7 Tage lang aufbewahrt. Sie können den Standard-Sicherungszeitplan nach dem Erstellen bearbeiten oder löschen.
  • NONE: Wenn in der Instanz eine neue Datenbank erstellt wird, wird nicht automatisch ein Standard-Sicherungszeitplan erstellt.

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

Verwaltetes Autoscaling hinzufügen

Sie können auch Instanzen der Enterprise- und Enterprise Plus-Version erstellen, um verwaltetes Autoscaling mit dem Befehl gcloud spanner instances create zu verwenden. Weitere Informationen finden Sie unter Managed Autoscaler für Spanner.

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

  gcloud spanner instances create INSTANCE_ID \
    --edition=EDITION \
    --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 \
    [--asymmetric-autoscaling-option \
       location=ASYMMETRIC_AUTOSCALING_LOCATION,min_nodes=ASYMMETRIC_AUTOSCALING_MIN,\
       max_nodes=ASYMMETRIC_AUTOSCALING_MAX,high_priority_cpu_target=ASYMMETRIC_CPU_TARGET]

oder

  gcloud spanner instances create INSTANCE_ID \
    --edition=EDITION \
    --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 \
    [--asymmetric-autoscaling-option \
       location=ASYMMETRIC_AUTOSCALING_LOCATION,min_nodes=ASYMMETRIC_AUTOSCALING_MIN,\
       max_nodes=ASYMMETRIC_AUTOSCALING_MAX,high_priority_cpu_target=ASYMMETRIC_CPU_TARGET]

Ersetzen Sie Folgendes:

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

Optionale Flags:

• --asymmetric-autoscaling-option: Verwenden Sie dieses Flag, um asymmetrisches Autoscaling zu aktivieren. Ersetzen Sie die folgenden Parameter:

  • ASYMMETRIC_AUTOSCALING_LOCATION: Wenn das Flag verwendet wird, ist dieser Parameter erforderlich. Der Standort der schreibgeschützten Region, die Sie asymmetrisch skalieren möchten.
  • ASYMMETRIC_AUTOSCALING_MIN: Optionaler Parameter. Die Mindestanzahl von Knoten beim Herunterskalieren.
  • ASYMMETRIC_AUTOSCALING_MAX: Optionaler Parameter. Die maximale Anzahl von Knoten beim Hochskalieren.
  • ASYMMETRIC_CPU_TARGET: Optionaler Parameter. Der Zielprozentsatz der zu verwendenden CPUs mit hoher Priorität, zwischen 10 und 90%. Wenn Sie die Kosten optimieren möchten, verwenden Sie einen höheren Prozentsatz.

Beispiele für die Verwendung benutzerdefinierter Konfigurationen

Führen Sie Folgendes aus, um eine Instanz test-instance in der regionalen Basiskonfiguration us-central1 zu erstellen:

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

Wenn Sie eine Instanz custom-eur6-instance in der benutzerdefinierten Multi-Region-Instanzkonfiguration custom-eur6 erstellen möchten, müssen Sie zuerst eine benutzerdefinierte Instanzkonfiguration erstellen.

Führen Sie dann diesen Befehl aus:

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

Nachdem Sie einen der vorherigen Befehle ausgeführt haben, sollte eine Meldung wie im folgenden Beispiel angezeigt werden:

Creating instance...done.

C++

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#

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

public class CreateInstanceAsyncSample
{
    public async Task<Instance> CreateInstanceAsync(
        string projectId,
        string instanceId,
        Instance.Types.Edition edition = Instance.Types.Edition.Standard)
    {
        // Create the InstanceAdminClient instance.
        InstanceAdminClient instanceAdminClient = await InstanceAdminClient.CreateAsync();

        // Initialize request parameters.
        Instance instance = new Instance
        {
            InstanceName = InstanceName.FromProjectInstance(projectId, instanceId),
            ConfigAsInstanceConfigName =