Instanz erstellen
Eine Bigtable-Instanz ist ein Container für Bigtable-Cluster. Eine Instanz mit mehr als einem Cluster verwendet Replikation. Sie können Cluster in bis zu acht Regionen erstellen, wobei in jeder Region so viele Cluster wie Zonen vorhanden sind.
Auf dieser Seite wird erläutert, wie Sie eine Instanz erstellen. Voraussetzung dafür ist die Kenntnis der Übersicht über Bigtable. Sie sollten auch die Übersicht über Instanzen, Cluster und Knoten lesen.
Hinweis
Bereiten Sie Ihre Umgebung vor:
-
Sign in to your Google Account.
If you don't already have one, sign up for a new account.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Cloud Bigtable API, Cloud Bigtable Admin API APIs.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Cloud Bigtable API, Cloud Bigtable Admin API APIs.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
- Führen Sie den folgenden Befehl aus, um die
cbt
-Befehlszeile zu installieren:gcloud components install cbt
Planen Sie Ihre Konfiguration:
Optional: Wenn Sie die Replikation aktivieren möchten, gehen Sie so vor:
- Nehmen Sie sich ein paar Minuten Zeit, um die Übersicht zu Replikationen zu lesen.
- Ermitteln Sie den Anwendungsfall für die Replikation.
- Bestimmen Sie die Region(en), in der sich die Instanz befinden soll, anhand des Anwendungsfalls und dem Standort Ihrer Anwendung und des Traffics.
- Entscheiden Sie, wie Sie Anwendungsprofile zum Weiterleiten eingehender Anfragen verwenden möchten.
Optional: Wenn Sie vom Kunden verwaltete Verschlüsselungsschlüssel (Customer-managed Encryption Keys, CMEK) statt der standardmäßigen von Google verwalteten Verschlüsselung verwenden möchten, führen Sie die Aufgaben unter CMEK-fähige Instanz erstellen aus und halten Sie Ihre CMEK-Schlüssel-ID bereit, bevor Sie Ihre neue Instanz erstellen. Nachdem eine Instanz erstellt wurde, können Sie den CMEK-Schutz nicht mehr hinzufügen und Sie können den CMEK-Schlüssel nicht mehr ändern oder ersetzen.
Instanz erstellen
So erstellen Sie eine Bigtable-Instanz:
Console
Wechseln Sie in der Google Cloud Console zur Seite Instanz erstellen.
Einen Namen für die Instanz eingeben.
In der Google Cloud Console wird dieser Name angezeigt, um Ihre Instanz zu identifizieren.
Geben Sie eine Instanz-ID ein.
Die Instanz-ID ist eine permanente Kennzeichnung für die Instanz.
Klicken Sie auf Weiter.
Entscheiden Sie sich, ob Sie in den Clustern SSD- oder HDD-Laufwerke verwenden möchten. In den meisten Fällen ist SSD am besten. Diese Entscheidung ist dauerhaft. Weitere Informationen
Klicken Sie auf Weiter.
Geben Sie eine Cluster-ID für den ersten Cluster ein.
Die Cluster-ID ist eine permanente Kennzeichnung für den Cluster.
Wählen Sie die Region und Zone aus, in denen der erste Cluster ausgeführt werden soll.
Wählen Sie einen Knotenskalierungsmodus für den Cluster aus. In den meisten Fällen sollten Sie die automatische Skalierung auswählen. Eine Anleitung zur Skalierung finden Sie unter Autoscaling.
- Geben Sie für Manuelle Knotenzuweisung die Anzahl der Bigtable-Knoten für den ersten Cluster ein. Wenn Sie sich nicht sicher sind, wie viele Knoten Sie benötigen, verwenden Sie den Standardwert. Sie können später weitere Knoten hinzufügen.
- Geben Sie unter Autoscaling Werte für Folgendes ein:
- Mindestanzahl von Knoten
- Maximale Anzahl von Knoten
- CPU-Auslastungsziel
- Speicherauslastungsziel
(Optional) Führen Sie die folgenden Schritte aus, um Ihre Instanz mit CMEK anstelle der von Google verwalteten Standardverschlüsselung zu schützen:
- Klicken Sie auf Verschlüsselungsoptionen anzeigen.
- Wählen Sie das Optionsfeld neben Vom Kunden verwalteter Verschlüsselungsschlüssel (CMEK) aus.
- Wählen Sie den Ressourcennamen für den CMEK aus, den Sie für den Cluster verwenden möchten, oder geben Sie ihn ein. Diese kann später nicht hinzugefügt werden.
- Wenn Sie aufgefordert werden, dem Dienstkonto des CMEK-Schlüssels die Berechtigung zu erteilen, klicken Sie auf Gewähren. Damit Sie diese Aufgabe ausführen können, muss Ihrem Nutzerkonto die Rolle "Cloud KMS-Administrator" zugewiesen sein.
- Klicken Sie auf Speichern.
(Optional) Führen Sie die folgenden zusätzlichen Schritte aus, um die Replikation jetzt zu aktivieren:
- Klicken Sie auf Erweiterte Optionen einblenden.
- Klicken Sie auf Cluster hinzufügen, geben Sie die Einstellungen für den Cluster ein und klicken Sie auf Hinzufügen. Wiederholen Sie diesen Schritt, um weitere Cluster in der Instanz zu erstellen. Sie können die Replikation auch später aktivieren, indem Sie einen Cluster hinzufügen.
Jede Zone in einer Region kann nur einen Cluster enthalten. Wenn die Schaltfläche Cluster hinzufügen deaktiviert ist, ändern Sie die Zone für den ersten Cluster.
Wenn Sie eine Instanz mit mehr als sechs Clustern erstellen möchten, erstellen Sie zuerst eine Instanz mit sechs Clustern und fügen Sie ihr dann weitere Cluster hinzu.
Klicken Sie auf Erstellen, um die Instanz zu erstellen.
Prüfen Sie die Replikationseinstellungen im standardmäßigen Anwendungsprofil, um zu bestimmen, ob sie für Ihren Replikations-Anwendungsfall sinnvoll sind. Möglicherweise müssen Sie das standardmäßige Anwendungsprofil aktualisieren oder benutzerdefinierte Anwendungsprofile erstellen.
gcloud
Verwenden Sie den Befehl
bigtable instances create
, um eine Instanz zu erstellen:gcloud bigtable instances create INSTANCE_ID \ --display-name=DISPLAY_NAME \ [--cluster-storage-type=CLUSTER_STORAGE_TYPE] \ [--cluster-config=id=CLUSTER_ID,zone=CLUSTER_ZONE, \ nodes=NODES] \ [--cluster-config=id=CLUSTER_ID,zone=CLUSTER_ZONE, \ autoscaling-min-nodes=AUTOSCALING_MIN_NODES, \ autoscaling-max-nodes=AUTOSCALING_MAX_NODES, \ autoscaling-cpu-target=AUTOSCALING_CPU_TARGET, \ autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET, \ kms-key=KMS_KEY]
Ersetzen Sie Folgendes:
INSTANCE_ID
: Die permanente Kennzeichnung der Instanz.DISPLAY_NAME
: Ein für Menschen lesbarer Name, der die Instanz in der Google Cloud Console identifiziert.CLUSTER_ID
: Die permanente Kennzeichnung des ClustersCLUSTER_ZONE
: Zone, in der der Cluster ausgeführt wird.
Sie müssen Sie mindestens einen Cluster für die Instanz konfigurieren, indem Sie das Flag
--cluster-config
verwenden. Zum Erstellen einer Instanz mit mehreren Clustern wiederholen Sie das Flag--cluster-config
für jeden Cluster.Bei der manuellen Knotenzuweisung ist die Einstellung von
nodes
im Flag--cluster-config
optional. Wenn kein Wert festgelegt ist, weist Bigtable dem Cluster automatisch Knoten basierend auf Ihrem Datenvolumen zu und optimiert ihn für eine Speicherauslastung von 50 %. Diese automatische Zuweisung von Knoten wirkt sich auf die Preise aus. Wenn Sie die Anzahl der Knoten in einem Cluster steuern möchten, ersetzen SieNODES
durch die gewünschte Anzahl der Knoten im Cluster. Weitere Informationen zu KnotenWählen Sie in den meisten Fällen Autoscaling anstelle der manuellen Knotenzuweisung aus. Geben Sie für „For_autoscaling“
autoscaling-
-Optionen im Flag--cluster-config
an (autoscaling-storage-target
ist optional) und verwenden Sie nichtnodes
. Informationen zur Auswahl der Werte für Ihre Autoscaling-Einstellungen finden Sie unter Autoscaling. Ersetzen Sie die folgenden Optionen durch die Optionen fürcluster-config
:AUTOSCALING_MIN_NODES
: Die Mindestanzahl von Knoten für den Cluster.AUTOSCALING_MAX_NODES
: Die maximale Anzahl von Knoten für den Cluster.AUTOSCALING_CPU_TARGET
: Die CPU-Zielauslastung für den Cluster in Prozent. Dieser Wert muss zwischen 10 und 80 liegen.AUTOSCALING_STORAGE_TARGET
: (Optional) Das Speicherauslastungsziel, das Bigtable durch Hinzufügen oder Entfernen von Knoten verwaltet, in GiB.KMS_KEY: Der CMEK für den Cluster.
Der Wert für KMS_KEY muss im folgenden Format angegeben werden:
projects/PROJECT/locations/LOCATION/keyRings/KEYRING/cryptoKeys/KEY
Ersetzen Sie Folgendes:
- PROJECT: Die permanente Kennzeichnung des Projekts
- LOCATION: Der Standort Ihres Clusters
- KEYRING: der Name des Schlüsselbunds, der den Schlüssel enthält
- KEY: der Name des Schlüssels
Hier ein Beispiel:
projects/examplestore.com:dev/locations/us-east1/keyRings/devt-cmek-2/cryptoKeys/key2
Wenn die Instanz durch einen CMEK geschützt ist, muss sich jeder Cluster in derselben Region wie sein CMEK befinden. Sie können CMEK-Cluster nur zu Instanzen hinzufügen, die bereits CMEK-geschützt sind. Weitere Informationen
Der Befehl akzeptiert die folgenden optionalen Flags:
--cluster-storage-type=CLUSTER_STORAGE_TYPE
: Der Speichertyp, der für die Instanz verwendet werden soll. Der Standardwert istSSD
. In den meisten Fällen ist der Standardwert am besten. Diese Entscheidung ist dauerhaft. Weitere Informationen--project=PROJECT
: Das Projekt, in dem der Cluster erstellt werden soll, wenn es sich vom aktuellen Projekt unterscheidet.
Prüfen Sie die Replikationseinstellungen im standardmäßigen Anwendungsprofil, um zu bestimmen, ob sie für Ihren Replikations-Anwendungsfall sinnvoll sind. Möglicherweise müssen Sie das standardmäßige Anwendungsprofil aktualisieren oder benutzerdefinierte Anwendungsprofile erstellen.
cbt
Erstellen Sie zuerst eine Instanz mit einem einzelnen Cluster. Verwenden Sie den Befehl
createinstance
, um eine Instanz zu erstellen:cbt createinstance INSTANCE_ID \ DISPLAY_NAME \ CLUSTER_ID \ CLUSTER_ZONE \ CLUSTER_NUM_NODES \ CLUSTER_STORAGE_TYPE
Machen Sie folgende Angaben:
INSTANCE_ID
: Die permanente Kennzeichnung der Instanz.DISPLAY_NAME
: Ein für Menschen lesbarer Name, der die Instanz in der Google Cloud Console identifiziert.CLUSTER_ID
: Die permanente Kennzeichnung des ClustersCLUSTER_ZONE
: Zone, in der der Cluster ausgeführt wird.CLUSTER_NUM_NODES
: Dieses Feld ist optional. Wenn kein Wert festgelegt ist, weist Bigtable automatisch Knoten basierend auf Ihrem Datenvolumen zu und optimiert die Speichernutzung auf 50 %. Wenn Sie die Anzahl der Knoten in einem Cluster steuern möchten, aktualisieren Sie den WertCLUSTER_NUM_NODES
. Die Anzahl der Knoten muss einen Wert ungleich Null haben. Weitere Informationen zu KnotenCLUSTER_STORAGE_TYPE
: Der Speichertyp, der für den Cluster verwendet werden soll. Für jeden Cluster in einer Instanz muss der gleiche Speichertyp verwendet werden. Die WerteSSD
undHDD
werden akzeptiert. In den meisten Fällen istSSD
am besten. Diese Entscheidung ist dauerhaft. Weitere Informationen
Verwenden Sie zum Aktivieren der Replikation den Befehl
createcluster
, um einen Cluster hinzuzufügen:cbt -instance=INSTANCE_ID \ createcluster CLUSTER_ID \ ZONE \ NUM_NODES \ STORAGE_TYPE
Machen Sie folgende Angaben:
INSTANCE_ID
: Die permanente Kennzeichnung der gerade erstellten InstanzCLUSTER_ID
: Die permanente Kennzeichnung des ClustersZONE
: Zone, in der der Cluster ausgeführt wird.Jede Zone in einer Region kann nur einen Cluster enthalten. Wenn eine Instanz beispielsweise einen Cluster in
us-east1-b
hat, können Sie einen Cluster in einer anderen Zone in derselben Region, z. B.us-east1-c
, oder in einer Zone in einer separaten Region wieeurope-west2-a
hinzufügen.NUM_NODES
: Dieses Feld ist optional. Wenn kein Wert festgelegt ist, weist Bigtable automatisch Knoten basierend auf Ihrem Datenvolumen zu und optimiert die Speichernutzung auf 50 %. Wenn Sie die Anzahl der Knoten in einem Cluster steuern möchten, aktualisieren Sie den Wert fürNUM_NODES
. Die Anzahl der Knoten muss einen Wert ungleich Null haben.In vielen Fällen ist es am sinnvollsten, wenn alle Cluster in einer Instanz gleich viele Knoten haben, aber es gibt Ausnahmen. Weitere Informationen zu Knoten und Replikation
STORAGE_TYPE
: Der Speichertyp, der für den Cluster verwendet werden soll. Für jeden Cluster in einer Instanz muss der gleiche Speichertyp verwendet werden. Die WerteSSD
undHDD
werden akzeptiert.
Optional: Prüfen Sie die Replikationseinstellungen im standardmäßigen Anwendungsprofil, um zu bestimmen, ob sie für Ihren Replikations-Anwendungsfall sinnvoll sind. Möglicherweise müssen Sie das standardmäßige Anwendungsprofil aktualisieren oder benutzerdefinierte Anwendungsprofile erstellen.
C++
Informationen zum Installieren und Verwenden der Clientbibliothek für Bigtable finden Sie unter Bigtable-Clientbibliotheken.
Richten Sie zur Authentifizierung bei Bigtable die Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
C#
Informationen zum Installieren und Verwenden der Clientbibliothek für Bigtable finden Sie unter Bigtable-Clientbibliotheken.
Richten Sie zur Authentifizierung bei Bigtable die Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Java
Informationen zum Installieren und Verwenden der Clientbibliothek für Bigtable finden Sie unter Bigtable-Clientbibliotheken.
Richten Sie zur Authentifizierung bei Bigtable die Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Node.js
Informationen zum Installieren und Verwenden der Clientbibliothek für Bigtable finden Sie unter Bigtable-Clientbibliotheken.
Richten Sie zur Authentifizierung bei Bigtable die Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
PHP
Informationen zum Installieren und Verwenden der Clientbibliothek für Bigtable finden Sie unter Bigtable-Clientbibliotheken.
Richten Sie zur Authentifizierung bei Bigtable die Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Python
Informationen zum Installieren und Verwenden der Clientbibliothek für Bigtable finden Sie unter Bigtable-Clientbibliotheken.
Richten Sie zur Authentifizierung bei Bigtable die Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Ruby
Informationen zum Installieren und Verwenden der Clientbibliothek für Bigtable finden Sie unter Bigtable-Clientbibliotheken.
Richten Sie zur Authentifizierung bei Bigtable die Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Nächste Schritte
- Mehr über die Verwendung von Instanzen, Clustern und Knoten durch Bigtable erfahren
- Weitere Informationen zur Bigtable-Replikation
- Für die Replikation das standardmäßige Anwendungsprofil prüfen und aktualisieren und nach Bedarf benutzerdefinierte Anwendungsprofile erstellen
- Mehr über das Ändern einer vorhandenen Instanz erfahren