Autorisierte Ansichten erstellen und verwalten

Console

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

   Liste der Instanzen öffnen

2. Klicken Sie auf die Instanz, die die Tabelle enthält, für die Sie eine autorisierte Ansicht erstellen möchten.

3. Klicken Sie im Navigationsbereich auf Bigtable Studio.

4. Klicken Sie auf Builder, um den Query Builder zu öffnen.

5. Wählen Sie die Tabelle aus, für die Sie eine autorisierte Ansicht erstellen möchten.

6. Fügen Sie Klauseln hinzu, um eine Abfrage zu erstellen, die nur Daten zurückgibt, auf die Nutzer der autorisierten Ansicht Zugriff haben sollen.

   • Zulässige Anweisungen für eine autorisierte Ansicht sind Zeilenschlüsselpräfix und Spalten (Spaltenqualifizierer).
   • Wenn Sie ein Präfix für den Spaltenqualifizierer angeben möchten, fügen Sie nach dem Präfix ein Sternchen ein. Wenn Sie beispielsweise alle Spalten einbeziehen möchten, die mit „data“ beginnen, geben Sie data* im Feld Spalten nach dem Namen der Spaltenfamilie ein.
   • Die Limit-Klausel wird ignoriert, wenn die autorisierte Ansicht gespeichert wird.
   • Weitere Informationen zur Verwendung des Query Builders finden Sie unter Abfragen in der Console erstellen.

7. Klicken Sie auf Ausführen.

8. Nachdem Sie geprüft haben, ob im Ergebnisbereich Daten angezeigt werden, die in der autorisierten Ansicht enthalten sein sollten, klicken Sie auf Als Ansicht speichern.

9. Geben Sie eine permanente ID für die autorisierte Ansicht ein, die noch nicht für die Tabelle verwendet wird.

10. Optional: Wenn Sie speichern möchten, ohne Zugriff zu gewähren, klicken Sie auf Speichern.

11. Optional: Wenn Sie die autorisierte Ansicht speichern und dann den Zugriff darauf konfigurieren möchten, klicken Sie auf Speichern und Zugriff gewähren. Weitere Informationen zur Zugriffssteuerung finden Sie unter Bigtable-Zugriffssteuerung mit IAM.

    1. Fügen Sie mindestens ein Hauptkonto hinzu und wählen Sie die Rolle aus, die diesem Hauptkonto oder dieser Gruppe von Hauptkonten zugewiesen werden soll.
    2. Optional: Wenn Sie Zugriff für weitere Rollen gewähren möchten, klicken Sie auf Weitere Rolle hinzufügen und geben Sie dann das Hauptkonto und die Rolle für jede zusätzliche Rolle ein.
    3. Klicken Sie auf Speichern.

gcloud

Führen Sie den Befehl bigtable authorized-views create aus: Weitere Informationen finden Sie in der Referenzdokumentation unter gcloud bigtable authorized-views create.

gcloud bigtable authorized-views create AUTHORIZED_VIEW_ID \
  --instance=INSTANCE_ID \
  --table=TABLE_ID \
  --definition-file=DEFINITION_FILE_PATH

Ersetzen Sie Folgendes:

• AUTHORIZED_VIEW_ID: eine permanente Kennung für die autorisierte Ansicht, die noch nicht für die Tabelle verwendet wird
• INSTANCE_ID: die permanente Kennung der Instanz, die die Tabelle enthält
• TABLE_ID: die permanente Kennzeichnung der Tabelle, für die Sie eine autorisierte Ansicht erstellen
• DEFINITION_FILE_PATH: Der Pfad zu einer gültigen JSON-formatierten Darstellung einer autorisierten Ansicht. Beispiele für korrekt formatierte Definitionsdateien finden Sie unter Beispiele für Definitionsdateien.

Sie können den Befehl auch ohne Angabe der Definitionsdatei ausführen. In diesem Fall wird in der gcloud CLI ein Editor geöffnet, in dem Sie aufgefordert werden, Werte anzugeben.

Wenn Sie prüfen möchten, ob die autorisierte Ansicht erstellt wurde, rufen Sie eine Liste der autorisierten Ansichten für die Tabelle ab.

Java

try {
  CreateAuthorizedViewRequest request =
      CreateAuthorizedViewRequest.of(tableId, authorizedViewId)
          .setAuthorizedViewType(
              SubsetView.create()
                  .addRowPrefix("")
                  .setFamilySubsets(
                      COLUMN_FAMILY,
                      FamilySubsets.create().addQualifierPrefix(COLUMN_QUALIFIER_NAME)));
  AuthorizedView authorizedView = adminClient.createAuthorizedView(request);
  System.out.printf("AuthorizedView: %s created successfully%n", authorizedView.getId());
} catch (NotFoundException e) {
  System.err.println(
      "Failed to create an authorized view from a non-existent table: " + e.getMessage());
}

Console

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

   Liste der Instanzen öffnen

2. Klicken Sie auf die Instanz, die die autorisierte Ansicht enthält.

3. Klicken Sie im Navigationsbereich auf Bigtable Studio.

4. Maximieren Sie im Explorer die Tabelle und Autorisierte Ansichten.

5. Klicken Sie neben der autorisierten Ansicht, die Sie ändern möchten, auf das Aktionsmenü more_vert und dann auf Öffnen.

6. Ändern oder fügen Sie Klauseln hinzu, um eine Abfrage zu erstellen, die nur Daten zurückgibt, auf die Nutzer der autorisierten Ansicht Zugriff haben sollen.

   • Zulässige Anweisungen für eine autorisierte Ansicht sind Zeilenschlüsselpräfix und Spalten (Spaltenqualifizierer).
   • Wenn Sie ein Präfix für den Spaltenqualifizierer angeben möchten, fügen Sie nach dem Präfix ein Sternchen ein. Wenn Sie beispielsweise alle Spalten einbeziehen möchten, die mit „data“ beginnen, geben Sie data* im Feld Spalten nach dem Namen der Spaltenfamilie ein.
   • Die Limit-Klausel wird ignoriert, wenn die autorisierte Ansicht gespeichert wird.
   • Weitere Informationen zur Verwendung des Query Builders finden Sie unter Abfragen in der Console erstellen.

7. Klicken Sie auf Ausführen.

8. Nachdem Sie geprüft haben, ob im Ergebnisbereich Daten angezeigt werden, die in der autorisierten Ansicht enthalten sein sollten, klicken Sie auf Als Ansicht speichern.

9. Geben Sie im Dialogfeld die ID der autorisierten Ansicht ein, die Sie geändert haben.

   Im Dialogfeld wird eine Warnung angezeigt, dass Sie die vorhandene autorisierte Ansicht überschreiben.

10. Optional: Wenn Sie speichern möchten, ohne Zugriff zu gewähren, klicken Sie auf Speichern.

    Wenn Sie den Zugriff für die autorisierte Ansicht nicht neu konfigurieren, nachdem Sie die zugrunde liegende Abfrage geändert haben, werden die vorherigen Einstellungen für die Zugriffssteuerung überschrieben und die autorisierte Ansicht erbt Berechtigungen von der Tabelle.

11. Optional: Wenn Sie die autorisierte Ansicht speichern und dann den Zugriff darauf konfigurieren möchten, klicken Sie auf Speichern und Zugriff gewähren. Weitere Informationen zur Zugriffssteuerung finden Sie unter Bigtable-Zugriffssteuerung mit IAM.

    1. Fügen Sie mindestens ein Hauptkonto hinzu und wählen Sie die Rolle aus, die diesem Hauptkonto oder dieser Gruppe von Hauptkonten zugewiesen werden soll.
    2. Optional: Wenn Sie Zugriff für weitere Rollen gewähren möchten, klicken Sie auf Weitere Rolle hinzufügen und geben Sie dann das Hauptkonto und die Rolle für jede zusätzliche Rolle ein.
    3. Klicken Sie auf Speichern.

gcloud

Ändern Sie eine autorisierte Ansicht mit dem Befehl bigtable authorized-views update. Weitere Informationen finden Sie in der Referenzdokumentation zu gcloud bigtable authorized-views update.

gcloud bigtable authorized-views update AUTHORIZED_VIEW_ID \
  --instance=INSTANCE_ID \
  --table=TABLE_ID \
  --definition-file=DEFINITION_FILE_PATH

Ersetzen Sie Folgendes:

• AUTHORIZED_VIEW_ID: Die permanente Kennzeichnung der autorisierten Ansicht
• INSTANCE_ID: Die permanente Kennzeichnung der Instanz
• TABLE_ID: Die permanente Kennzeichnung der Quelltabelle
• DEFINITION_FILE_PATH: Der Pfad zu einer gültigen JSON-formatierten Darstellung einer autorisierten Ansicht. Beispiele für korrekt formatierte Definitionsdateien finden Sie unter Beispiele für Definitionsdateien.

Sie können den Befehl auch ohne Angabe der Definitionsdatei ausführen. In diesem Fall wird in der gcloud CLI ein Editor geöffnet, in dem Sie aufgefordert werden, Werte anzugeben.

Optional: Wenn Sie verhindern möchten, dass in der gcloud CLI eine Bestätigungsaufforderung mit dem Unterschied zwischen der aktuellen autorisierten Ansichtsstruktur und der Struktur nach der Aktualisierung angezeigt wird, hängen Sie dem Befehl das Flag --no-interactive an.

Java

try {
  // Update to an authorized view permitting everything.
  UpdateAuthorizedViewRequest request =
      UpdateAuthorizedViewRequest.of(tableId, authorizedViewId)
          .setAuthorizedViewType(
              SubsetView.create()
                  .addRowPrefix("")
                  .setFamilySubsets(
                      COLUMN_FAMILY, FamilySubsets.create().addQualifierPrefix("")));
  AuthorizedView authorizedView = adminClient.updateAuthorizedView(request);
  System.out.printf("AuthorizedView: %s updated successfully%n", authorizedView.getId());
} catch (NotFoundException e) {
  System.err.println("Failed to modify a non-existent authorized view: " + e.getMessage());
}

Console

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

   Liste der Instanzen öffnen

2. Klicken Sie auf die Instanz, die die autorisierte Ansicht enthält.

3. Klicken Sie im Navigationsbereich auf Bigtable Studio.

4. Maximieren Sie im Explorer die Tabelle und Autorisierte Ansichten.

5. Klicken Sie neben der autorisierten Ansicht, die Sie löschen möchten, auf das Aktionsmenü more_vert und dann auf Löschen.

gcloud

Löschen Sie eine autorisierte Ansicht mit dem Befehl bigtable instances tables authorized-views delete. Weitere Informationen finden Sie in der Referenzdokumentation unter gcloud bigtable authorized-views delete.

gcloud bigtable authorized-views delete AUTHORIZED_VIEW_ID \
  --instance=INSTANCE_ID \
  --table=TABLE_ID

Ersetzen Sie Folgendes:

• AUTHORIZED_VIEW_ID: Die permanente Kennzeichnung der autorisierten Ansicht
• INSTANCE_ID: Die permanente Kennzeichnung der Instanz
• TABLE_ID: Die permanente Kennzeichnung der Quelltabelle

Optional: Wenn Sie verhindern möchten, dass in der gcloud CLI eine Bestätigungsaufforderung angezeigt wird, in der Sie das Löschen bestätigen oder abbrechen müssen, hängen Sie das Flag --nointeractive an den Befehl an.

Java

try {
  adminClient.deleteAuthorizedView(tableId, authorizedViewId);
  System.out.printf("AuthorizedView: %s deleted successfully%n", authorizedViewId);
} catch (NotFoundException e) {
  System.err.println("Failed to delete a non-existent authorized view: " + e.getMessage());
}

Console

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

   Liste der Instanzen öffnen

2. Klicken Sie auf die Instanz, die die autorisierte Ansicht enthält.

3. Klicken Sie im Navigationsbereich auf Bigtable Studio.

4. Maximieren Sie im Explorer die Tabelle und Autorisierte Ansichten.

gcloud

Führen Sie den Befehl bigtable authorized-views list aus: Weitere Informationen finden Sie in der Referenzdokumentation unter gcloud bigtable authorized-views list.

gcloud bigtable authorized-views list \
  --instance=INSTANCE_ID \
  --table=TABLE_ID

Ersetzen Sie Folgendes:

• INSTANCE_ID: Die permanente Kennzeichnung der Instanz
• TABLE_ID: Die permanente Kennzeichnung der Tabelle

Java

List<String> authorizedViewIds = new ArrayList<>();
try {
  authorizedViewIds = adminClient.listAuthorizedViews(tableId);
  for (String authorizedViewId : authorizedViewIds) {
    System.out.println(authorizedViewId);
  }
} catch (NotFoundException e) {
  System.err.println(
      "Failed to list authorized views from a non-existent table: " + e.getMessage());
}

Console

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

   Liste der Instanzen öffnen

2. Klicken Sie auf die Instanz, die die autorisierte Ansicht enthält.

3. Klicken Sie im Navigationsbereich auf Bigtable Studio.

4. Maximieren Sie im Explorer die Tabelle und Autorisierte Ansichten.

5. Klicken Sie neben der autorisierten Ansicht, die Sie aufrufen möchten, auf das Aktionsmenü more_vert und dann auf Öffnen.

gcloud

Führen Sie den Befehl bigtable instances tables authorized-views describe aus, um Details zu einer autorisierten Ansicht abzurufen. Weitere Informationen finden Sie in der Referenzdokumentation unter gcloud bigtable authorized-views describe.

gcloud bigtable authorized-views describe \
–-instance=INSTANCE_ID \
–-table=TABLE_ID \
AUTHORIZED_VIEW_ID

Ersetzen Sie Folgendes:

• INSTANCE_ID: Die permanente Kennzeichnung der Instanz
• TABLE_ID: Die permanente Kennzeichnung der Tabelle
• AUTHORIZED_VIEW_ID: Die permanente Kennzeichnung der autorisierten Ansicht

Java

AuthorizedView authorizedView = null;
try {
  authorizedView = adminClient.getAuthorizedView(tableId, authorizedViewId);
  SubsetView subsetView = (SubsetView) authorizedView.getAuthorizedViewType();

  for (ByteString rowPrefix : subsetView.getRowPrefixes()) {
    System.out.printf("Row Prefix: %s%n", rowPrefix.toStringUtf8());
  }
  for (Map.Entry<String, FamilySubsets> entry : subsetView.getFamilySubsets().entrySet()) {
    for (ByteString qualifierPrefix : entry.getValue().getQualifierPrefixes()) {
      System.out.printf(
          "Column Family: %s, Qualifier Prefix: %s%n",
          entry.getKey(), qualifierPrefix.toStringUtf8());
    }
    for (ByteString qualifier : entry.getValue().getQualifiers()) {
      System.out.printf(
          "Column Family: %s, Qualifier: %s%n", entry.getKey(), qualifier.toStringUtf8());
    }
  }
} catch (NotFoundException e) {
  System.err.println(
      "Failed to retrieve metadata from a non-existent authorized view: " + e.getMessage());
}

Console

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

   Liste der Instanzen öffnen

2. Klicken Sie auf die Instanz, die die autorisierte Ansicht enthält.

3. Klicken Sie im Navigationsbereich auf Bigtable Studio.

4. Maximieren Sie im Explorer-Bereich die Tabelle und Autorisierte Ansichten.

5. Klicken Sie neben dem Namen der autorisierten Ansicht auf das Aktionsmenü more_vert und dann auf Zugriff gewähren.

6. Fügen Sie mindestens ein Hauptkonto hinzu und wählen Sie die Rolle aus, die diesem Hauptkonto oder dieser Gruppe von Hauptkonten zugewiesen werden soll.

7. Optional: Wenn Sie Zugriff für weitere Rollen gewähren möchten, klicken Sie auf Weitere Rolle hinzufügen und geben Sie dann das Hauptkonto und die Rolle für jede zusätzliche Rolle ein.

8. Klicken Sie auf Speichern.

gcloud

Verwenden Sie den Befehl bigtable authorized-views add-iam-policy-binding, um Zugriff auf eine autorisierte Ansicht zu gewähren. Weitere Informationen finden Sie in der Referenzdokumentation unter gcloud bigtable authorized-views add-iam-policy-binding.

gcloud bigtable authorized-views add-iam-policy-binding AUTH_VIEW_ID \
--instance=INSTANCE_ID --table=TABLE_ID \
--member=PRINCIPAL --role=ROLE

Ersetzen Sie Folgendes:

• AUTH_VIEW_ID: die ID der autorisierten Ansicht
• TABLE_ID: Die ID der Tabelle, auf der die autorisierte Ansicht basiert.
• INSTANCE_ID: die Instanz, die die Tabelle enthält
• PRINCIPAL: das Hauptkonto (Nutzer), dem Sie Zugriff gewähren möchten, z. B. user:222larabrown@gmail.com
• ROLE: Die Rolle, die Sie zuweisen, z. B. roles/bigtable.reader.