Configurer un volume externe pour Google Cloud Storage¶

Étape 1 : Créer un volume externe dans Snowflake¶

Créez un volume externe via la commande CREATE EXTERNAL VOLUME.

L’exemple suivant crée un volume externe qui définit un emplacement de stockage GCS unique avec chiffrement :

CREATE EXTERNAL VOLUME my_gcs_external_volume
  STORAGE_LOCATIONS =
    (
      (
        NAME = 'my-us-west-2'
        STORAGE_PROVIDER = 'GCS'
        STORAGE_BASE_URL = 'gcs://mybucket1/path1/'
        ENCRYPTION=(TYPE='GCS_SSE_KMS' KMS_KEY_ID = '1234abcd-12ab-34cd-56ef-1234567890ab')
      )
    );

Étape 2 : récupérer le compte de service GCS de votre compte Snowflake¶

Pour récupérer l’ID du compte de service GCS automatiquement créé pour votre compte Snowflake, utilisez la commande DESCRIBE EXTERNAL VOLUME. Indiquez le nom du volume externe que vous avez créé précédemment.

Par exemple :

DESC EXTERNAL VOLUME my_gcs_external_volume;

Copy

Enregistrez la valeur de la propriété STORAGE_GCP_SERVICE_ACCOUNT dans la sortie (par exemple, service-account-id@project1-123456.iam.gserviceaccount.com).

Snowflake provisionne un seul compte de service GCS pour l’ensemble de votre compte Snowflake. Tous les volumes externes de GCS utilisent ce compte de service.

Étape 3 : Accorder au compte de service des autorisations lui permettant d’accéder à des objets du compartiment¶

Dans cette étape, vous configurez les autorisations d’accès à IAM pour Snowflake dans votre Google Cloud console.

Étape 4 : Vérifier l’accès au stockage¶

Pour vérifier que Snowflake peut s’authentifier avec succès auprès de votre fournisseur de stockage, appelez la fonction SYSTEM$VERIFY_EXTERNAL_VOLUME.

SELECT SYSTEM$VERIFY_EXTERNAL_VOLUME('my_external_volume');

Error assuming AWS_ROLE:
STS is not activated in this region for account:<external volume id>. Your account administrator can activate STS in this region using the IAM Console.

Étape 1 : récupérer le compte de service GCS de votre compte Snowflake¶

1. Connectez-vous à Snowsight.

2. Dans le coin inférieur gauche, sélectionnez votre nom » Switch role, puis sélectionnez ACCOUNTADMIN ou un rôle disposant du privilège CREATE EXTERNAL VOLUME.

   Pour plus d’informations, voir Changer de rôle principal.

3. Dans le menu de navigation, sélectionnez Catalog » External data.

4. Sélectionnez l’onglet External volumes.

5. Sélectionnez + Create.

6. Sélectionnez Google Cloud Storage puis Next.

7. À partir de la page Grant storage access, copiez la valeur de GCS service account dans un éditeur de texte.

   Snowflake provisionne un seul compte de service GCS pour l’ensemble de votre compte Snowflake. Tous les volumes externes de GCS utilisent ce compte de service.

Étape 2 : Octroi d’autorisations au compte de service pour accéder à des objets de compartiment¶

Dans cette étape, vous configurez les autorisations d’accès à IAM pour Snowflake dans votre Google Cloud console.

Étape 3 : Créer un volume externe¶

Pour créer un volume externe dans Snowflake en utilisant Snowsight, procédez comme suit :

1. Connectez-vous à Snowsight.

2. Dans le coin inférieur gauche, sélectionnez votre nom » Switch role, puis sélectionnez ACCOUNTADMIN ou un rôle disposant du privilège CREATE EXTERNAL VOLUME.

   Pour obtenir des instructions, voir Changer de rôle principal.

3. Dans le menu de navigation, sélectionnez Catalog » External data.

4. Sélectionnez l’onglet External volumes.

5. Sélectionnez + Create.

6. Sélectionnez Google Cloud Storage puis Next.

7. Sélectionnez Next.

   Note

   Vous avez déjà accordé l’accès au stockage plus tôt lorsque vous avez récupéré le compte de service GCS de votre compte Snowflake et attribué le rôle personnalisé au compte de service GCS.

8. Pour configurer votre volume externe, à partir de la page Configure external volume, renseignez les champs suivants :

   Champ	Description
   External volume name	Saisissez un nom pour votre volume externe.
   Storage base URL	Spécifie l’URL de base de votre emplacement de stockage Cloud.
   Encryption (optional)	Indique le type de chiffrement utilisé. Les valeurs possibles sont les suivantes : None (default) : Pas de chiffrement. SSE-KMS (enter key) : Chiffrement côté serveur à l’aide de clés stockées dans KMS. Pour plus d’informations, voir clés de chiffrement gérées par le client.
   Access scope	Spécifie si les opérations d’écriture sont autorisées pour le volume externe ; doit être défini sur Allow writes pour les tables suivantes : Tables Iceberg qui utilisent Snowflake comme catalogue. Tables Iceberg qui utilisent un catalogue externe et sont accessibles en écriture. Les tables Iceberg gérées en externe sont accessibles en écriture lorsque vous y accédez via une base de données liée à un catalogue qui possède le paramètre ALLOWED_WRITE_OPERATIONS défini sur TRUE. Pour les tables Iceberg créées à partir de fichiers de table Delta, la définition de ce paramètre sur Allow writes permet à Snowflake d’écrire des métadonnées Iceberg dans votre stockage externe. Pour plus d’informations, voir Tables basées sur Delta. La valeur de ce champ doit également correspondre aux autorisations définies sur le compte de stockage Cloud pour chaque emplacement de stockage spécifié. Note Si vous prévoyez d’utiliser le volume externe pour lire des tables Iceberg gérées en externe, vous pouvez désactiver ce champ. Snowflake n’écrit pas de fichiers de métadonnées Iceberg ni de données dans votre stockage Cloud lorsque vous lisez des tables dans un catalogue Iceberg externe.
   Scope	Choisissez si le volume externe doit devenir l’emplacement par défaut pour les futures tables Iceberg. Les valeurs possibles sont les suivantes : Do not set a default : Ne définissez le volume externe comme valeur par défaut nulle part. Account : Définissez le volume externe comme volume par défaut pour les tables Iceberg créées sous l’ensemble du compte. Specific database : Définissez le volume externe comme volume par défaut pour les tables Iceberg créées sous la base de données que vous spécifiez. Pour spécifier cette base de données, utilisez la liste déroulante Database qui apparaît lorsque vous sélectionnez Specific database. Specific schema : Définissez le volume externe comme volume par défaut pour les tables Iceberg créées sous le schéma que vous spécifiez. Pour spécifier ce schéma, utilisez la liste déroulante Database qui apparaît pour sélectionner d’abord la base de données parente du schéma, puis le schéma.
   Comment (optional)	Spécifie un commentaire pour le volume externe.
   Connectivity	Indique s’il faut utiliser la connectivité privée sortante pour renforcer votre sécurité. Pour obtenir des informations sur l’utilisation de ce paramètre, voir Connectivité privée vers des volumes externes pour Google Cloud. Les valeurs possibles sont les suivantes : Public (default) : Utilisez l’Internet public. Private (Private Service Connect) : Utilisez la connexion privée sortante.

9. Sélectionnez Next.

   Sur la page Verify connection & create volume, Snowflake vérifie votre connexion à Google Cloud Storage, puis affiche un message « Connecté avec succès ».

   Note

   Si Snowflake n’est pas en mesure de vérifier votre connexion, vérifiez votre autorisation ou la configuration de votre volume externe, puis sélectionnez Verify again.

10. Sélectionnez Create.