Anwendungsprofile erstellen und konfigurieren

Mit Bigtable-Anwendungsprofilen (Anwendungsprofile) können Sie Routingrichtlinien, Compute-Optionen und Einstellungen für die Arbeitslastisolierung für eingehende Clientanfragen angeben. Sie können Traffic über bereitgestellte Clusterknoten weiterleiten, isolierte Lesevorgänge mit hohem Durchsatz mit serverlosem Computing von Data Boost ausführen oder Punktlesevorgänge an eine In-Memory-Ebene (Vorschau) auf Enterprise Plus-Instanzen weiterleiten.

Hinweis

Bevor Sie ein Anwendungsprofil erstellen oder konfigurieren, lesen Sie die folgenden Dokumente:

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Bigtable-Administrator (roles/bigtable.admin) für die Instanz zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erstellen, Konfigurieren oder Löschen eines App-Profils benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Anwendungsprofil erstellen

Sie können viele verschiedene benutzerdefinierte App-Profile für jede Instanz erstellen. Benutzerdefinierte App-Profile dienen dazu, die Interaktion der einzelnen Anwendung oder Anwendungsfunktion mit einer Instanz zu steuern. Sie können beispielsweise ein Anwendungsprofil für eine Batchanwendung verwenden, um den Traffic auf einen einzelnen Cluster zu beschränken, und ein anderes Anwendungsprofil, um eine Hochverfügbarkeit für eine andere Anwendung zu gewährleisten.

Standardanwendungsprofil erstellen

So erstellen Sie ein Standard-App-Profil:

Console

  1. Öffnen Sie in der Cloud de Confiance Console die Liste der Bigtable-Instanzen.

    Liste der Instanzen öffnen

  2. Klicken Sie auf die Instanz, für die Sie das Anwendungsprofil erstellen möchten.

  3. Klicken Sie im linken Bereich auf Anwendungsprofile.

  4. Klicken Sie auf Anwendungsprofil erstellen.

  5. Wählen Sie Standard aus.

  6. Klicken Sie auf Weiter.

  7. Geben Sie die Anwendungsprofil-ID ein.

    Die Anwendungsprofil-ID ist eine permanente Kennzeichnung für das App-Profil. Ihre Anwendung gibt diese ID an, wenn sie eine Verbindung zu Bigtable herstellt.

  8. Geben Sie eine Beschreibung des App-Profils ein.

  9. Wählen Sie unter Cluster-Routing entweder Single-Cluster-Routing oder Multi-Cluster-Routing aus. Weitere Informationen

  10. Wenn Sie Single-Cluster auswählen:

    1. Wählen Sie in der Liste Cluster den Cluster aus, an den Anfragen weitergeleitet werden sollen.

    2. Wenn Sie Transaktionen für einzelne Zeilen aktivieren möchten, setzen Sie ein Häkchen in das Kästchen Transaktionen für einzelne Zeilen zulassen.

  11. Wenn Sie Multi-Cluster auswählen:

    1. Wenn Sie Anfragen an einen beliebigen Cluster in der Instanz weiterleiten möchten, wählen Sie in der Liste Clustergruppe die Option Beliebiger Cluster aus.
    2. Wenn Sie das Anfragerouting auf einige Cluster in der Instanz beschränken möchten (Clustergruppen-Routing), wählen Sie jeden Cluster aus, den Sie in die Routinggruppe aufnehmen möchten, und klicken Sie dann auf OK.
    3. Wenn Sie Lese- und Schreibanfragen für einzelne Zeilen basierend auf dem Zeilenschlüssel der Anfrage an einen bestimmten Cluster weiterleiten möchten, wählen Sie Zeilenaffinität aktivieren aus.
  12. Weisen Sie unter Routingpriorität auswählen Ihren Anfragen eine Routingpriorität zu, indem Sie eine der folgenden Optionen auswählen:

    • Hoch: für latenzempfindliche Anfragen
    • Mittel: Für Anfragen für allgemeine Zwecke
    • Niedrig: Für Hintergrundaufgaben oder weniger zeitkritische Vorgänge
  13. Klicken Sie zum Erstellen des App-Profils auf Erstellen.

  14. Aktualisieren Sie Ihren Anwendungscode zur Verbindungsherstellung mit Bigtable so, dass das neue App-Profil verwendet wird.

gcloud

  1. Wenn Sie die Instanz-ID nicht kennen, verwenden Sie den Befehl bigtable instances list, um eine Liste der Instanzen des Projekts aufzurufen:

    gcloud bigtable instances list
    
  2. Verwenden Sie den Befehl bigtable app-profiles create, um ein Anwendungsprofil zu erstellen:

    gcloud bigtable app-profiles create APP_PROFILE_ID \
        --instance=INSTANCE_ID \
        [--description=DESCRIPTION] \
        [--force] \
        [--route-any] \
        [--restrict-to=CLUSTER_ID_1, CLUSTER_ID_2...] \
        [--route-to=CLUSTER_ID] \
        [--transactional-writes] \
        [--priority=PRIORITY] \
        [--row-affinity]
    

    Machen Sie folgende Angaben:

    • APP_PROFILE_ID: Die permanente Kennzeichnung des Anwendungsprofils.
    • INSTANCE_ID: Die permanente Kennzeichnung der Instanz.

    Der Befehl akzeptiert die folgenden optionalen Flags:

    • --description=DESCRIPTION: Eine detaillierte Beschreibung des App-Profils.
    • --force: Warnungen zu potenziellen Problemen und Konflikten mit anderen Anwendungsprofilen werden ignoriert.
    • --route-any: Aktivieren Sie Multi-Cluster-Routing, um Anfragen an einen beliebigen verfügbaren Cluster weiterzuleiten.

      Dieses Flag darf nicht mit den Flags --route-to oder --transactional-writes kombiniert werden.

    • --restrict-to=CLUSTER_ID_1, CLUSTER_ID_2...: Eine Liste der Cluster, an die Anfragen weitergeleitet werden sollen. Verwenden Sie diese Option, wenn Sie Anfragen nur an einige der Cluster in der Instanz weiterleiten möchten.

      Dieses Flag darf nicht mit den Flags --route-to oder --transactional-writes kombiniert werden.

    • --route-to=CLUSTER_ID: Die Cluster-ID, an die alle Anfragen weitergeleitet werden sollen. Dieses Flag aktiviert Single-Cluster-Routing.

      Dieses Flag darf nicht mit dem Flag --route-any kombiniert werden.

    • --transactional-writes: Aktivieren Sie Transaktionen in einer einzelnen Zeile im App-Profil.

      Dieses Flag darf nicht mit dem Flag --route-any oder --restrict-to kombiniert werden.

    • --priority=PRIORITY: Die Prioritätsstufe, die für das Anwendungsprofil verwendet werden soll. Zulässige Werte sind PRIORITY_HIGH, PRIORITY_MEDIUM oder PRIORITY_LOW.

    • --row-affinity: Zeilenaffinitätsrouting im App-Profil aktivieren.

      Dieses Flag darf nicht mit den Flags --route-to oder --transactional-writes kombiniert werden.

  3. Aktualisieren Sie Ihren Anwendungscode zur Verbindungsherstellung mit Bigtable so, dass das neue App-Profil verwendet wird.

Anwendungsprofil mit In-Memory-Stufe erstellen

So erstellen Sie ein App-Profil in einem Cluster mit aktivierter In-Memory-Ebene:

Console

  1. Öffnen Sie in der Cloud de Confiance Console die Liste der Bigtable-Instanzen.

    Liste der Instanzen öffnen

  2. Klicken Sie auf die Instanz, für die Sie das Anwendungsprofil erstellen möchten.

  3. Klicken Sie im linken Bereich auf Anwendungsprofile.

  4. Klicken Sie auf Anwendungsprofil erstellen.

  5. Wählen Sie In-Memory-Stufe aus.

  6. Klicken Sie auf Weiter.

  7. Geben Sie die Anwendungsprofil-ID ein.

    Die Anwendungsprofil-ID ist eine permanente Kennzeichnung für das App-Profil. Ihre Anwendung gibt diese ID an, wenn sie eine Verbindung zu Bigtable herstellt.

  8. Geben Sie eine Beschreibung des App-Profils ein.

  9. Wählen Sie unter Cluster-Routing einen Cluster mit aktivierter In-Memory-Stufe aus.

    Für Cluster mit In-Memory-Stufe muss Single-Cluster-Routing verwendet werden.

  10. Wenn Sie Transaktionen für einzelne Zeilen aktivieren müssen, wählen Sie Transaktionen für einzelne Zeilen zulassen aus.

  11. Weisen Sie unter Routingpriorität auswählen Ihren Anfragen eine Routingpriorität zu, indem Sie eine der folgenden Optionen auswählen:

    • Hoch: für latenzempfindliche Anfragen
    • Mittel: Für Anfragen für allgemeine Zwecke
    • Niedrig: Für Hintergrundaufgaben oder weniger zeitkritische Vorgänge
  12. Klicken Sie auf Erstellen, um das App-Profil zu erstellen.

  13. Aktualisieren Sie Ihren Anwendungscode zur Verbindungsherstellung mit Bigtable so, dass das neue App-Profil verwendet wird.

gcloud

  1. Wenn Sie die Instanz-ID nicht kennen, verwenden Sie den Befehl bigtable instances list, um eine Liste der Instanzen des Projekts aufzurufen:

    gcloud bigtable instances list
    
  2. Verwenden Sie den Befehl gcloud beta bigtable app-profiles create, um ein Anwendungsprofil zu erstellen:

    gcloud beta bigtable app-profiles create APP_PROFILE_ID \
        --instance=INSTANCE_ID \
        --route-to=CLUSTER_ID \
        --use-memory-layer \
        [--description=DESCRIPTION] \
        [--transactional-writes] \
        [--priority=PRIORITY]
    

    Machen Sie folgende Angaben:

    • APP_PROFILE_ID: Die permanente Kennzeichnung des Anwendungsprofils.
    • INSTANCE_ID: Die permanente Kennzeichnung der Instanz.

    Der Befehl akzeptiert die folgenden optionalen Flags:

    • --route-to=CLUSTER_ID: Die Cluster-ID, an die alle Anfragen weitergeleitet werden sollen. Dieses Flag aktiviert Single-Cluster-Routing.
    • --use-memory-layer: Routenanfragen mit diesem App-Profil an die In-Memory-Stufe weiterleiten. Dieses Flag ist auf die Enterprise Plus-Version und das Routing mit einem einzelnen Cluster beschränkt.
    • --description=DESCRIPTION: Eine detaillierte Beschreibung des App-Profils.
    • --transactional-writes: Aktivieren Sie Transaktionen in einer einzelnen Zeile im App-Profil.
    • --priority=PRIORITY: Die Prioritätsstufe von Anfragen, die über das App-Profil gesendet werden. Zulässige Werte sind PRIORITY_HIGH, PRIORITY_MEDIUM oder PRIORITY_LOW. Anfrageprioritäten haben keine Auswirkungen auf Anfragen, die für die In-Memory-Stufe infrage kommen.
  3. Aktualisieren Sie Ihren Anwendungscode zur Verbindungsherstellung mit Bigtable so, dass das neue App-Profil verwendet wird.

Data Boost-Anwendungsprofil erstellen

So erstellen Sie ein Data Boost-Anwendungsprofil, das serverloses Computing von Data Boost verwendet: Um sicherzustellen, dass Ihre Arbeitslast mit Data Boost kompatibel ist, lesen Sie die Beschränkungen.

Console

  1. Öffnen Sie in der Cloud de Confiance Console die Liste der Bigtable-Instanzen.

    Liste der Instanzen öffnen

  2. Klicken Sie auf die Instanz, für die Sie das Anwendungsprofil erstellen möchten.

  3. Klicken Sie im linken Bereich auf Anwendungsprofile.

  4. Klicken Sie auf Anwendungsprofil erstellen.

  5. Wählen Sie Data Boost aus.

  6. Klicken Sie auf Weiter.

  7. Geben Sie die Anwendungsprofil-ID ein.

    Die Anwendungsprofil-ID ist eine permanente Kennzeichnung für das App-Profil. Ihre Anwendung gibt diese ID an, wenn sie eine Verbindung zu Bigtable herstellt.

  8. Geben Sie eine Beschreibung des App-Profils ein.

  9. Wählen Sie unter Cluster-Routing den Cluster aus, an den Anfragen weitergeleitet werden sollen.

  10. Klicken Sie auf App-Profil erstellen, um das App-Profil zu erstellen.

  11. Aktualisieren Sie Ihren Anwendungscode zur Verbindungsherstellung mit Bigtable so, dass das neue App-Profil verwendet wird.

gcloud

  1. Wenn Sie die Instanz-ID nicht kennen, verwenden Sie den Befehl bigtable instances list, um eine Liste der Instanzen des Projekts aufzurufen:

    gcloud bigtable instances list
    
  2. Verwenden Sie den Befehl gcloud beta bigtable app-profiles create, um ein Anwendungsprofil zu erstellen:

    gcloud bigtable app-profiles create APP_PROFILE_ID \
        --instance=INSTANCE_ID \
        --data-boost \
        --data-boost-compute-billing-owner=HOST_PAYS \
        --route-to=CLUSTER_ID
    

    Machen Sie folgende Angaben:

    • APP_PROFILE_ID: Die permanente Kennzeichnung des Anwendungsprofils.
    • INSTANCE_ID: Die permanente Kennzeichnung der Instanz.
    • CLUSTER_ID: Die Cluster-ID, an die alle Anfragen weitergeleitet werden sollen. Dieses Flag aktiviert Single-Cluster-Routing.

Mit einem benutzerdefinierten Anwendungsprofil verbinden

Nachdem Sie ein benutzerdefiniertes Anwendungsprofil erstellt haben, können Sie Ihren Code so aktualisieren, dass Ihre Anwendung beim Verbinden mit Bigtable das Anwendungsprofil verwendet.

Die folgenden Beispiele zeigen, wie Sie ein Anwendungsprofil angeben, wenn Ihre Anwendung einen Bigtable-Client erstellt und eine Verbindung zu einer Instanz herstellt. Ersetzen Sie [APP_PROFILE_ID] durch den entsprechenden Wert.

C#

var client = BigtableClient.Create(appProfileId: "[APP_PROFILE_ID]");

Go

clientConf := bigtable.ClientConfig{AppProfile:"[APP_PROFILE_ID]"}
client, err = bigtable.NewClientWithConfig(ctx, project, instance, clientConf)

HBase Java

// If using BigtableOptions directly:
optionsBuilder.setAppProfileId("[APP_PROFILE_ID]");

// If using BigtableOptionsFactory:
configuration.set(BigtableOptionsFactory.APP_PROFILE_ID_KEY, "[APP_PROFILE_ID]");

// If using system properties, set "google.bigtable.app_profile.id" to
// "[APP_PROFILE_ID]"

// If using CloudBigtableIO for Cloud Dataflow:
config.withConfiguration(BigtableOptionsFactory.APP_PROFILE_ID_KEY,
                         "[APP_PROFILE_ID]");

Node.js

const bigtable = new Bigtable({appProfileId: '[APP_PROFILE_ID]'});

Python

from google.cloud import bigtable

client = bigtable.Client(project=project_id)
instance = client.instance(instance_id)
table = bigtable.table.Table(table_id, instance, '[APP_PROFILE_ID]')

Anwendungsprofil aktualisieren

Sie können die App-Profile einer Instanz jederzeit aufrufen und deren Einstellungen aktualisieren. Dabei gibt Bigtable immer dann eine Warnung aus, wenn eine Aktualisierung zu unerwarteten Änderungen im Verhalten führen könnte.

Informationen zum Aktualisieren eines Anwendungsprofils von „Standard“ auf „Data Boost“ oder von „Data Boost“ auf „Standard“ finden Sie unter Anwendungsprofil umwandeln.

Standardanwendungsprofil aktualisieren

So aktualisieren Sie ein Standard-App-Profil:

Console

  1. Öffnen Sie in der Cloud de Confiance Console die Liste der Bigtable-Instanzen.

    Liste der Instanzen öffnen

  2. Klicken Sie auf die Instanz mit dem App-Profil, das Sie aktualisieren möchten.

  3. Klicken Sie im linken Bereich auf Anwendungsprofile.

  4. Klicken Sie für das App-Profil, das Sie aktualisieren möchten, auf  App-Profil bearbeiten.

  5. Aktualisieren Sie die Einstellungen nach Bedarf.

  6. Klicken Sie auf Speichern oder auf Abbrechen, um den Vorgang zu beenden, ohne die Änderungen zu speichern.

gcloud

  1. Wenn Sie die Instanz-ID nicht kennen, verwenden Sie den Befehl bigtable instances list, um eine Liste der Instanzen des Projekts aufzurufen:

    gcloud bigtable instances list
    
  2. Wenn Sie die ID des Anwendungsprofils nicht kennen, verwenden Sie den Befehl bigtable app-profiles list, um eine Liste der Anwendungsprofile der Instanz aufzurufen:

    gcloud bigtable app-profiles list --instance=INSTANCE_ID
    

    Ersetzen Sie INSTANCE_ID durch die permanente Kennzeichnung der Instanz.

  3. Optional: Verwenden Sie den Befehl bigtable app-profiles describe, um die Einstellungen des App-Profils aufzurufen:

    gcloud bigtable app-profiles describe APP_PROFILE_ID \
        --instance=INSTANCE_ID
    

    Machen Sie folgende Angaben:

    • APP_PROFILE_ID: Die permanente Kennzeichnung des Anwendungsprofils.
    • INSTANCE_ID: Die permanente Kennzeichnung der Instanz.
  4. Verwenden Sie den Befehl bigtable app-profiles update, um die Einstellungen des Anwendungsprofils zu aktualisieren:

    gcloud bigtable app-profiles update APP_PROFILE_ID \
        --instance=INSTANCE_ID \
        [--description=DESCRIPTION] \
        [--force] \
        [--route-any] \
        [--restrict-to=CLUSTER_ID_1, CLUSTER_ID_2...]
        [--route-to=CLUSTER_ID] \
        [--transactional-writes] \
        [--row-affinity]
    

    Machen Sie folgende Angaben:

    • APP_PROFILE_ID: Die permanente Kennzeichnung des Anwendungsprofils.
    • INSTANCE_ID: Die permanente Kennzeichnung der Instanz.

    Der Befehl akzeptiert die folgenden optionalen Flags:

    • --description=DESCRIPTION: Eine detaillierte Beschreibung des App-Profils.
    • --force: Warnungen zu potenziellen Problemen und Konflikten mit anderen Anwendungsprofilen werden ignoriert.
    • --route-any: Aktivieren Sie Multi-Cluster-Routing, um Anfragen an einen beliebigen verfügbaren Cluster weiterzuleiten.

      Dieses Flag darf nicht mit den Flags --route-to oder --transactional-writes kombiniert werden.

    • --restrict-to=CLUSTER_ID_1, CLUSTER_ID_2...: Eine Liste der Cluster, an die Anfragen weitergeleitet werden sollen. Verwenden Sie diese Option, wenn Sie Anfragen nur an einige der Cluster in der Instanz weiterleiten möchten.

      Dieses Flag darf nicht mit den Flags --route-to oder --transactional-writes kombiniert werden.

    • --route-to=CLUSTER_ID: Die Cluster-ID, an die alle Anfragen weitergeleitet werden sollen. Dieses Flag aktiviert Single-Cluster-Routing.

      Dieses Flag darf nicht mit dem Flag --route-any kombiniert werden.

    • --transactional-writes: Aktivieren Sie Transaktionen in einer einzelnen Zeile im App-Profil.

      Dieses Flag darf nicht mit dem Flag --route-any kombiniert werden.

    • --priority=PRIORITY: Die Prioritätsstufe, die für das App-Profil verwendet wird. Zulässige Werte sind PRIORITY_HIGH, PRIORITY_MEDIUM oder PRIORITY_LOW.

Anwendungsprofil mit In-Memory-Stufe aktualisieren

So aktualisieren Sie ein App-Profil in einem Cluster, in dem die In-Memory-Ebene aktiviert ist:

Console

  1. Öffnen Sie in der Cloud de Confiance Console die Liste der Bigtable-Instanzen.

    Liste der Instanzen öffnen

  2. Klicken Sie auf die Instanz mit dem App-Profil, das Sie aktualisieren möchten.

  3. Klicken Sie im linken Bereich auf Anwendungsprofile.

  4. Klicken Sie für das App-Profil, das Sie aktualisieren möchten, auf  App-Profil bearbeiten.

  5. Aktualisieren Sie die Einstellungen nach Bedarf.

  6. Klicken Sie auf Speichern oder auf Abbrechen, um den Vorgang zu beenden, ohne die Änderungen zu speichern.

gcloud

  1. Wenn Sie die Instanz-ID nicht kennen, verwenden Sie den Befehl bigtable instances list, um eine Liste der Instanzen des Projekts aufzurufen:

    gcloud bigtable instances list
    
  2. Wenn Sie die ID des Anwendungsprofils nicht kennen, verwenden Sie den Befehl bigtable app-profiles list, um eine Liste der Anwendungsprofile der Instanz aufzurufen:

    gcloud bigtable app-profiles list --instance=INSTANCE_ID
    

    Ersetzen Sie INSTANCE_ID durch die permanente Kennzeichnung der Instanz.

  3. Optional: Verwenden Sie den Befehl gcloud bigtable app-profiles describe, um die Einstellungen des App-Profils aufzurufen:

    gcloud bigtable app-profiles describe APP_PROFILE_ID \
        --instance=INSTANCE_ID
    

    Machen Sie folgende Angaben:

    • APP_PROFILE_ID: Die permanente Kennzeichnung des Anwendungsprofils.
    • INSTANCE_ID: Die permanente Kennzeichnung der Instanz.
  4. Verwenden Sie den Befehl gcloud beta bigtable app-profiles update, um die Einstellungen des Anwendungsprofils zu aktualisieren:

    gcloud beta bigtable app-profiles update APP_PROFILE_ID \
        --instance=INSTANCE_ID \
        --route-to=CLUSTER_ID \
        [--description=DESCRIPTION] \
        [--transactional-writes] \
        [--priority=PRIORITY] \
        [--use-memory-layer] \
        [--no-use-memory-layer]
    

    Machen Sie folgende Angaben:

    • APP_PROFILE_ID: Die permanente Kennzeichnung des Anwendungsprofils.
    • INSTANCE_ID: Die permanente Kennzeichnung der Instanz.

    Der Befehl akzeptiert die folgenden optionalen Flags:

    • --description=DESCRIPTION: Eine detaillierte Beschreibung des App-Profils.
    • --route-to=CLUSTER_ID: Die Cluster-ID, an die alle Anfragen weitergeleitet werden sollen. Dieses Flag aktiviert Single-Cluster-Routing.
    • --transactional-writes: Aktivieren Sie Transaktionen in einer einzelnen Zeile im App-Profil.
    • --priority=PRIORITY: Die Prioritätsstufe, die für das App-Profil verwendet wird. Zulässige Werte sind PRIORITY_HIGH, PRIORITY_MEDIUM oder PRIORITY_LOW.
    • --use-memory-layer: Routenanfragen mit diesem App-Profil an die In-Memory-Ebene weiterleiten. Verwenden Sie --no-use-memory-layer, um das Routing zur In-Memory-Stufe für dieses Anwendungsprofil zu deaktivieren. Dieses Flag ist auf die Enterprise Plus-Version und das Single-Cluster-Routing beschränkt.

Data Boost-Anwendungsprofil aktualisieren

So aktualisieren Sie den Cluster, aus dem ein Data Boost-Anwendungsprofil Daten liest:

Console

  1. Öffnen Sie in der Cloud de Confiance Console die Liste der Bigtable-Instanzen.

    Liste der Instanzen öffnen

  2. Klicken Sie in der Spalte Anwendungsprofile auf das Anwendungsprofil, das Sie ansehen oder aktualisieren möchten.

    Wenn Sie das App-Profil, das Sie bearbeiten möchten, nicht sehen, können Sie eine vollständige Liste aufrufen, indem Sie auf den Namen der Instanz und dann im linken Bereich auf App-Profile klicken.

  3. Wählen Sie das neue Cluster aus, zu dem der Traffic weitergeleitet werden soll, und klicken Sie dann auf Speichern.

gcloud

  1. Wenn Sie die Instanz-ID nicht kennen, verwenden Sie den Befehl bigtable instances list, um eine Liste der Instanzen des Projekts aufzurufen:

    gcloud bigtable instances list
    
  2. Wenn Sie die ID des Anwendungsprofils nicht kennen, verwenden Sie den Befehl bigtable app-profiles list, um eine Liste der Anwendungsprofile der Instanz aufzurufen:

    gcloud bigtable app-profiles list --instance=INSTANCE_ID
    

    Ersetzen Sie INSTANCE_ID durch die permanente Kennzeichnung der Instanz.

  3. Optional: Verwenden Sie den Befehl gcloud bigtable app-profiles describe, um die Einstellungen des App-Profils aufzurufen:

    gcloud bigtable app-profiles describe APP_PROFILE_ID \
        --instance=INSTANCE_ID
    

    Machen Sie folgende Angaben:

    • APP_PROFILE_ID: Die permanente Kennzeichnung des Anwendungsprofils.
    • INSTANCE_ID: Die permanente Kennzeichnung der Instanz.
  4. Verwenden Sie den Befehl gcloud beta bigtable app-profiles update, um die Einstellungen des Anwendungsprofils zu aktualisieren:

    gcloud beta bigtable app-profiles update APP_PROFILE_ID \
        --instance=INSTANCE_ID \
        --route-to=CLUSTER_ID
    

    Machen Sie folgende Angaben:

    • APP_PROFILE_ID: Die permanente Kennzeichnung des Anwendungsprofils.
    • INSTANCE_ID: Die permanente Kennzeichnung der Instanz.
    • CLUSTER_ID: die ID des neuen Clusters, aus dem gelesen werden soll

Anwendungsprofil umwandeln

Sie können ein Standardanwendungsprofil in ein Data Boost-Anwendungsprofil oder ein Data Boost-Anwendungsprofil in ein Standardanwendungsprofil umwandeln. Bevor Sie ein App-Profil umwandeln, sollten Sie sich die Informationen unter Änderungen am App-Profil ansehen.

Von Standard zu Data Boost wechseln

Bevor Sie ein Anwendungsprofil von Standard (bereitgestellte Knoten für das Computing) auf serverloses Computing von Data Boost umstellen, sollten Sie die Messwerte zur Data Boost-Eignung prüfen. Beschränkungen von Data Boost sollten Sie ebenfalls beachten.

Console

  1. Öffnen Sie in der Cloud de Confiance Console die Liste der Bigtable-Instanzen.

    Liste der Instanzen öffnen

  2. Klicken Sie in der Spalte Anwendungsprofile auf das App-Profil, das Sie aktualisieren möchten.

    Wenn Sie das zu bearbeitende Anwendungsprofil nicht finden, können Sie eine vollständige Liste abrufen. Klicken Sie dazu auf den Namen der Instanz und dann im linken Bereich auf Anwendungsprofile.

  3. Wählen Sie Data Boost aus.

  4. Wählen Sie den Cluster aus, an den Anfragen weitergeleitet werden sollen.

  5. Klicken Sie auf Speichern.

gcloud

  1. Wenn Sie die Instanz-ID nicht kennen, verwenden Sie den Befehl bigtable instances list, um eine Liste der Instanzen des Projekts aufzurufen:

    gcloud bigtable instances list
    
  2. Wenn Sie die ID des Anwendungsprofils nicht kennen, verwenden Sie den Befehl bigtable app-profiles list, um eine Liste der Anwendungsprofile der Instanz aufzurufen:

    gcloud bigtable app-profiles list --instance=INSTANCE_ID
    

    Ersetzen Sie INSTANCE_ID durch die permanente Kennzeichnung der Instanz.

  3. Optional: Verwenden Sie den Befehl bigtable app-profiles describe, um die Einstellungen des App-Profils aufzurufen:

    gcloud bigtable app-profiles describe APP_PROFILE_ID \
        --instance=INSTANCE_ID
    

    Machen Sie folgende Angaben:

    • APP_PROFILE_ID: Die permanente Kennzeichnung des Anwendungsprofils.
    • INSTANCE_ID: Die permanente Kennzeichnung der Instanz.
  4. Verwenden Sie den gcloud beta bigtable app-profiles update-Befehl, um ein Anwendungsprofil von Standard in Data Boost zu konvertieren:

    gcloud bigtable app-profiles update APP_PROFILE_ID \
        --instance=INSTANCE_ID \
        --data-boost \
        --data-boost-compute-billing-owner=HOST_PAYS \
        --route-to=CLUSTER_ID
    

    Machen Sie folgende Angaben:

    • APP_PROFILE_ID: Die permanente Kennzeichnung des Anwendungsprofils.
    • INSTANCE_ID: Die permanente Kennzeichnung der Instanz.
    • CLUSTER_ID: Die Cluster-ID, an die alle Anfragen weitergeleitet werden sollen. Dieses Flag aktiviert Single-Cluster-Routing.

Von Data Boost zu Standard wechseln

So ändern Sie ein Anwendungsprofil von Data Boost (serverloses Computing) zu Standard (bereitgestellte Knoten für das Computing):

Console

  1. Öffnen Sie in der Cloud de Confiance Console die Liste der Bigtable-Instanzen.

    Liste der Instanzen öffnen

  2. Klicken Sie in der Spalte Anwendungsprofile auf das App-Profil, das Sie aktualisieren möchten.

    Wenn Sie das zu bearbeitende Anwendungsprofil nicht finden, können Sie eine vollständige Liste abrufen. Klicken Sie dazu auf den Namen der Instanz und dann im linken Bereich auf Anwendungsprofile.

  3. Wählen Sie Standard aus.

  4. Klicken Sie auf Weiter.

  5. Optional: Bearbeiten Sie die Beschreibung des App-Profils.

  6. Wählen Sie unter Cluster-Routing entweder Single-Cluster-Routing oder Multi-Cluster-Routing aus. Weitere Informationen

  7. Wenn Sie Single-Cluster auswählen:

    1. Wählen Sie in der Liste Cluster den Cluster aus, an den Anfragen weitergeleitet werden sollen.

    2. Wenn Sie Transaktionen für einzelne Zeilen aktivieren möchten, setzen Sie ein Häkchen in das Kästchen Transaktionen für einzelne Zeilen zulassen.

  8. Wenn Sie Multi-Cluster auswählen:

    1. Wenn Sie Anfragen an einen beliebigen Cluster in der Instanz weiterleiten möchten, wählen Sie in der Liste Clustergruppe die Option Beliebiger Cluster aus.
    2. Wenn Sie das Anfragerouting auf einige Cluster in der Instanz beschränken möchten (Clustergruppen-Routing), wählen Sie jeden Cluster aus, den Sie in die Routinggruppe aufnehmen möchten, und klicken Sie dann auf OK.
    3. Wenn Sie Lese- und Schreibanfragen für einzelne Zeilen basierend auf dem Zeilenschlüssel der Anfrage an einen bestimmten Cluster weiterleiten möchten, wählen Sie Zeilenaffinität aktivieren aus.
  9. Weisen Sie unter Routingpriorität auswählen Ihren Anfragen eine Routingpriorität zu, indem Sie eine der folgenden Optionen auswählen:

    • Hoch: für latenzempfindliche Anfragen
    • Mittel: Für Anfragen für allgemeine Zwecke
    • Niedrig: Für Hintergrundaufgaben oder weniger zeitkritische Vorgänge
  10. Klicken Sie auf Speichern.

gcloud

  1. Wenn Sie die Instanz-ID nicht kennen, verwenden Sie den Befehl bigtable instances list, um eine Liste der Instanzen des Projekts aufzurufen:

    gcloud bigtable instances list
    
  2. Wenn Sie die ID des Anwendungsprofils nicht kennen, verwenden Sie den Befehl bigtable app-profiles list, um eine Liste der Anwendungsprofile der Instanz aufzurufen:

    gcloud bigtable app-profiles list --instance=INSTANCE_ID
    

    Ersetzen Sie INSTANCE_ID durch die permanente Kennzeichnung der Instanz.

  3. Optional: Verwenden Sie den Befehl bigtable app-profiles describe, um die Einstellungen des App-Profils aufzurufen:

    gcloud bigtable app-profiles describe APP_PROFILE_ID \
        --instance=INSTANCE_ID
    
  4. Verwenden Sie den Befehl gcloud beta bigtable app-profiles update, um das App-Profil zu konvertieren:

    gcloud bigtable app-profiles update APP_PROFILE_ID \
        --instance=INSTANCE_ID \
        --standard \
        [--route-any] \
        [--restrict-to=CLUSTER_ID_1, CLUSTER_ID_2...]
        [--route-to=CLUSTER_ID] \
        [--transactional-writes]
    

Machen Sie folgende Angaben:

  • APP_PROFILE_ID: Die permanente Kennzeichnung des Anwendungsprofils.
  • INSTANCE_ID: Die permanente Kennzeichnung der Instanz.

Der Befehl akzeptiert die folgenden optionalen Flags:

  • --route-any: Aktivieren Sie Multi-Cluster-Routing, um Anfragen an einen beliebigen verfügbaren Cluster weiterzuleiten.

    Dieses Flag darf nicht mit den Flags --route-to oder --transactional-writes kombiniert werden.

  • --restrict-to=CLUSTER_ID_1, CLUSTER_ID_2...: Eine Liste der Cluster, an die Anfragen weitergeleitet werden sollen. Verwenden Sie diese Option, wenn Sie Anfragen nur an einige der Cluster in der Instanz weiterleiten möchten.

    Dieses Flag darf nicht mit den Flags --route-to oder --transactional-writes kombiniert werden.

  • --route-to=CLUSTER_ID: Die Cluster-ID, an die alle Anfragen weitergeleitet werden sollen. Dieses Flag aktiviert Single-Cluster-Routing.

    Dieses Flag darf nicht mit dem Flag --route-any kombiniert werden.

  • --transactional-writes: Aktivieren Sie Transaktionen in einer einzelnen Zeile im App-Profil.

    Dieses Flag darf nicht mit den Flags --route-any oder --restrict-to kombiniert werden.

Anwendungsprofil löschen

Sie können die benutzerdefinierten App-Profile einer Instanz löschen, nicht jedoch das standardmäßige App-Profil.

So löschen Sie ein benutzerdefiniertes App-Profil:

Console

  1. Öffnen Sie in der Cloud de Confiance Console die Liste der Bigtable-Instanzen.

    Liste der Instanzen öffnen

  2. Klicken Sie auf die Instanz, die das zu löschende Anwendungsprofil enthält.

  3. Klicken Sie im linken Bereich auf Anwendungsprofile.

  4. Öffnen Sie das Dreipunkt-Menü  und klicken Sie dann auf Anwendungsprofil löschen. Ein Bestätigungsdialog erscheint.

  5. Folgen Sie der Anleitung im Bestätigungsdialogfeld und klicken Sie dann auf Löschen.

gcloud

  1. Wenn Sie die Instanz-ID nicht kennen, verwenden Sie den Befehl bigtable instances list, um eine Liste der Instanzen des Projekts aufzurufen:

    gcloud bigtable instances list
    
  2. Wenn Sie die ID des Anwendungsprofils nicht kennen, verwenden Sie den Befehl bigtable app-profiles list, um eine Liste der Anwendungsprofile der Instanz aufzurufen:

    gcloud bigtable app-profiles list --instance=INSTANCE_ID
    

    Ersetzen Sie INSTANCE_ID durch die permanente Kennzeichnung der Instanz.

  3. Verwenden Sie den Befehl bigtable app-profiles delete, um das Anwendungsprofil zu löschen:

    gcloud bigtable app-profiles delete APP_PROFILE_ID \
        --instance=INSTANCE_ID \
        [--force]
    

    Machen Sie folgende Angaben:

    • APP_PROFILE_ID: Die permanente Kennzeichnung des Anwendungsprofils.
    • INSTANCE_ID: Die permanente Kennzeichnung der Instanz.

    Der Befehl akzeptiert das folgende optionale Flag:

    --force: Warnungen zu potenziellen Problemen und Konflikten mit anderen Anwendungsprofilen werden ignoriert.