Créer et gérer des vues autorisées

Console

1. Ouvrez la liste des instances Bigtable dans la console Google Cloud .

   Ouvrir la liste des instances

2. Cliquez sur l'instance contenant la table pour laquelle vous souhaitez créer une vue autorisée.

3. Dans le volet de navigation, cliquez sur Bigtable Studio.

4. Cliquez sur Générateur pour ouvrir le générateur de requêtes.

5. Choisissez la table pour laquelle vous souhaitez créer une vue autorisée.

6. Ajoutez des clauses pour créer une requête qui ne renvoie que les données auxquelles vous souhaitez que les utilisateurs de la vue autorisée aient accès.

   • Les clauses acceptables pour une vue autorisée sont row key prefix (préfixe de clé de ligne) et columns (colonnes, c'est-à-dire les qualificatifs de colonne).
   • Pour spécifier un préfixe de qualificatif de colonne, ajoutez un astérisque après le préfixe. Par exemple, pour inclure toutes les colonnes commençant par "data", saisissez data* dans le champ Colonnes après le nom de la famille de colonnes.
   • La clause Limit est ignorée lorsque la vue autorisée est enregistrée.
   • Pour en savoir plus sur l'utilisation du générateur de requêtes, consultez Créer des requêtes dans la console.

7. Cliquez sur Exécuter.

8. Une fois que vous avez vérifié que le volet des résultats affiche les données qui doivent être incluses dans la vue autorisée, cliquez sur Enregistrer en tant que vue.

9. Saisissez un identifiant permanent pour la vue autorisée qui n'est pas déjà utilisé pour la table.

10. Facultatif : Pour enregistrer sans accorder l'accès, cliquez sur Enregistrer.

11. Facultatif : Pour enregistrer la vue autorisée et configurer l'accès, cliquez sur Enregistrer et accorder l'accès. Pour en savoir plus sur le contrôle des accès, consultez Contrôle des accès Bigtable avec IAM.

    1. Ajoutez au moins un compte principal et sélectionnez le rôle qui doit lui être attribué ou au groupe de comptes principaux.
    2. Facultatif : Pour accorder l'accès à des rôles supplémentaires, cliquez sur Ajouter un autre rôle, puis saisissez le compte principal et le rôle pour chaque rôle supplémentaire.
    3. Cliquez sur Enregistrer.

gcloud

Exécutez la commande bigtable authorized-views create. Pour en savoir plus, consultez la documentation de référence sur gcloud bigtable authorized-views create.

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

Remplacez les éléments suivants :

• AUTHORIZED_VIEW_ID : identifiant permanent de la vue autorisée qui n'est pas déjà utilisé pour la table.
• INSTANCE_ID : identifiant permanent de l'instance contenant la table.
• TABLE_ID : identifiant permanent de la table pour laquelle vous créez une vue autorisée
• DEFINITION_FILE_PATH : chemin d'accès à une représentation valide au format JSON d'une vue autorisée. Pour obtenir des exemples de fichiers de définition correctement mis en forme, consultez Exemples de fichiers de définition.

Vous pouvez également exécuter la commande sans fournir le fichier de définition. Dans ce cas, la gcloud CLI ouvre un éditeur et vous invite à saisir des valeurs.

Pour confirmer que la vue autorisée a été créée, obtenez la liste des vues autorisées pour la table.

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. Ouvrez la liste des instances Bigtable dans la console Google Cloud .

   Ouvrir la liste des instances

2. Cliquez sur l'instance contenant la vue autorisée.

3. Dans le volet de navigation, cliquez sur Bigtable Studio.

4. Dans l'explorateur, développez la table et Vues autorisées.

5. À côté de la vue autorisée que vous souhaitez modifier, cliquez sur le menu d'actions more_vert, puis sur Ouvrir.

6. Modifiez ou ajoutez des clauses pour créer une requête qui ne renvoie que les données auxquelles vous souhaitez que les utilisateurs de la vue autorisée aient accès.

   • Les clauses acceptables pour une vue autorisée sont row key prefix (préfixe de clé de ligne) et columns (colonnes, c'est-à-dire les qualificatifs de colonne).
   • Pour spécifier un préfixe de qualificatif de colonne, ajoutez un astérisque après le préfixe. Par exemple, pour inclure toutes les colonnes commençant par "data", saisissez data* dans le champ Colonnes après le nom de la famille de colonnes.
   • La clause Limit est ignorée lorsque la vue autorisée est enregistrée.
   • Pour en savoir plus sur l'utilisation du générateur de requêtes, consultez Créer des requêtes dans la console.

7. Cliquez sur Exécuter.

8. Une fois que vous avez vérifié que le volet des résultats affiche les données qui doivent être incluses dans la vue autorisée, cliquez sur Enregistrer en tant que vue.

9. Dans la boîte de dialogue, saisissez l'ID de la vue autorisée que vous avez modifiée.

   La boîte de dialogue affiche un message vous avertissant que vous êtes sur le point d'écraser la vue autorisée existante.

10. Facultatif : Pour enregistrer sans accorder l'accès, cliquez sur Enregistrer.

11. Facultatif : Pour enregistrer la vue autorisée et configurer l'accès, cliquez sur Enregistrer et accorder l'accès. Pour en savoir plus sur le contrôle des accès, consultez Contrôle des accès Bigtable avec IAM.

    1. Ajoutez au moins un compte principal et sélectionnez le rôle qui doit lui être attribué ou au groupe de comptes principaux.
    2. Facultatif : Pour accorder l'accès à des rôles supplémentaires, cliquez sur Ajouter un autre rôle, puis saisissez le compte principal et le rôle pour chaque rôle supplémentaire.
    3. Cliquez sur Enregistrer.

gcloud

Modifiez une vue autorisée à l'aide de la commande bigtable authorized-views update. Pour en savoir plus, consultez la documentation de référence sur gcloud bigtable authorized-views update.

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

Remplacez les éléments suivants :

• AUTHORIZED_VIEW_ID : identifiant permanent de la vue autorisée.
• INSTANCE_ID : identifiant permanent de l'instance.
• TABLE_ID : identifiant permanent de la table source.
• DEFINITION_FILE_PATH : chemin d'accès à une représentation valide au format JSON d'une vue autorisée. Pour obtenir des exemples de fichiers de définition correctement mis en forme, consultez Exemples de fichiers de définition.

Vous pouvez également exécuter la commande sans fournir le fichier de définition. Dans ce cas, la gcloud CLI ouvre un éditeur et vous invite à saisir des valeurs.

Facultatif : Pour empêcher gcloud CLI d'afficher une invite de confirmation indiquant la différence entre la structure de la vue autorisée actuelle et celle après l'application de la mise à jour, ajoutez l'option --no-interactive à la commande.

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. Ouvrez la liste des instances Bigtable dans la console Google Cloud .

   Ouvrir la liste des instances

2. Cliquez sur l'instance contenant la vue autorisée.

3. Dans le volet de navigation, cliquez sur Bigtable Studio.

4. Dans l'explorateur, développez la table et Vues autorisées.

5. À côté de la vue autorisée que vous souhaitez supprimer, cliquez sur le menu d'actions more_vert, puis sur Supprimer.

gcloud

Supprimez une vue autorisée à l'aide de la commande bigtable instances tables authorized-views delete. Pour en savoir plus, consultez la documentation de référence sur gcloud bigtable authorized-views delete.

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

Remplacez les éléments suivants :

• AUTHORIZED_VIEW_ID : identifiant permanent de la vue autorisée.
• INSTANCE_ID : identifiant permanent de l'instance.
• TABLE_ID : identifiant permanent de la table source.

Facultatif : Pour empêcher gcloud CLI d'afficher une invite de confirmation vous demandant de confirmer ou d'annuler la suppression, ajoutez l'option --nointeractive à la commande.

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. Ouvrez la liste des instances Bigtable dans la console Google Cloud .

   Ouvrir la liste des instances

2. Cliquez sur l'instance contenant la vue autorisée.

3. Dans le volet de navigation, cliquez sur Bigtable Studio.

4. Dans l'explorateur, développez la table et Vues autorisées.

gcloud

Exécutez la commande bigtable authorized-views list. Pour en savoir plus, consultez la documentation de référence sur gcloud bigtable authorized-views list.

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

Remplacez les éléments suivants :

• INSTANCE_ID : identifiant permanent de l'instance.
• TABLE_ID : identifiant permanent de la table.

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. Ouvrez la liste des instances Bigtable dans la console Google Cloud .

   Ouvrir la liste des instances

2. Cliquez sur l'instance contenant la vue autorisée.

3. Dans le volet de navigation, cliquez sur Bigtable Studio.

4. Dans l'explorateur, développez la table et Vues autorisées.

5. À côté de la vue autorisée que vous souhaitez afficher, cliquez sur le menu d'actions more_vert, puis sur Ouvrir.

gcloud

Pour obtenir des informations sur une vue autorisée, exécutez la commande bigtable instances tables authorized-views describe. Pour en savoir plus, consultez la documentation de référence gcloud bigtable authorized-views describe.

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

Remplacez les éléments suivants :

• INSTANCE_ID : identifiant permanent de l'instance.
• TABLE_ID : identifiant permanent de la table.
• AUTHORIZED_VIEW_ID : identifiant permanent de la vue autorisée.

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. Ouvrez la liste des instances Bigtable dans la console Google Cloud .

   Ouvrir la liste des instances

2. Cliquez sur l'instance contenant la vue autorisée.

3. Dans le volet de navigation, cliquez sur Bigtable Studio.

4. Dans le volet de l'explorateur, développez la table et Vues autorisées.

5. À côté du nom de la vue autorisée, cliquez sur le menu d'action more_vert, puis sur Accorder l'accès.

6. Ajoutez au moins un compte principal et sélectionnez le rôle qui doit lui être attribué ou au groupe de comptes principaux.

7. Facultatif : Pour accorder l'accès à des rôles supplémentaires, cliquez sur Ajouter un autre rôle, puis saisissez le compte principal et le rôle pour chaque rôle supplémentaire.

8. Cliquez sur Enregistrer.

gcloud

Pour accorder l'accès à une vue autorisée, utilisez la commande bigtable authorized-views add-iam-policy-binding. Pour en savoir plus, consultez la documentation de référence sur 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

Remplacez les éléments suivants :

• AUTH_VIEW_ID : ID de la vue autorisée
• TABLE_ID : ID de la table à partir de laquelle la vue autorisée est créée
• INSTANCE_ID : instance contenant la table
• PRINCIPAL : entité principale (utilisateur) à laquelle vous souhaitez accorder l'accès, par exemple user:222larabrown@gmail.com
• ROLE : rôle que vous attribuez, tel que roles/bigtable.reader.