Création d’une zone de préparation S3

Une zone de préparation externe (c.-à-d S3) spécifie l’emplacement de stockage des fichiers de données afin que les données contenues dans les fichiers puissent être chargées dans une table.

Les données peuvent être chargées directement à partir de fichiers dans un compartiment S3 spécifié, avec ou sans chemin de dossier (ou préfixe, dans la terminologie S3). Si le chemin se termine par /, tous les objets du dossier S3 correspondant sont chargés.

Note

Dans l’étape précédente, si vous avez suivi les instructions pour configurer un rôle IAM AWS avec les politiques et autorisations requises pour accéder à votre compartiment S3 externe, vous avez déjà créé une zone de préparation S3. Vous pouvez ignorer cette étape et continuer vers Copie des données d’une zone de préparation S3.

Dans ce chapitre :

Zones de préparation externes

En plus du chargement direct à partir de fichiers dans des compartiments S3, Snowflake prend en charge la création de zones de préparation externes nommées, qui encapsulent toutes les informations nécessaires à la mise en zone de préparation de fichiers, notamment :

  • Le compartiment S3 où les fichiers sont mis en zone de préparation.

  • Les informations d’identification S3 ou de l’objet d’intégration de stockage nommé pour le compartiment (s’il est protégé).

  • Une clé de chiffrement (si les fichiers du compartiment ont été chiffrés).

Les zones de préparation externes nommées sont facultatives, mais recommandées lorsque vous prévoyez de charger régulièrement des données du même emplacement.

Création d’une zone de préparation externe

Vous pouvez créer une zone de préparation nommée via l’interface Web ou SQL :

Interface Web

Cliquez sur Databases Databases tab » <nom_bdd> » Stages

SQL

CREATE STAGE

Exemple

L’exemple suivant utilise SQL pour créer une zone de préparation externe nommée my_s3_stage qui fait référence à un compartiment S3 privé/protégé nommé mybucket avec un chemin de dossier nommé encrypted_files. L’instruction CREATE comprend des identifications de connexion S3 (associées à un utilisateur IAM AWS) et une clé de chiffrement principale. La zone de préparation fait référence à un objet de format de fichier nommé my_csv_format créé dans Préparation du chargement des données :

CREATE OR REPLACE STAGE my_s3_stage URL='s3://mybucket/encrypted_files/'
  CREDENTIALS=(AWS_KEY_ID='1a2b3c' AWS_SECRET_KEY='4x5y6z')
  ENCRYPTION=(MASTER_KEY = 'eSxX0jzYfIamtnBKOEOwq80Au6NbSgPH5r4BDDwOaO8=')
  FILE_FORMAT = my_csv_format;

Note

En spécifiant un objet de format de fichier nommé (ou des options de format de fichier individuelles) pour la zone de préparation, il n’est pas nécessaire de spécifier ultérieurement les mêmes options de format de fichier dans la commande COPY utilisée pour charger les données de la zone de préparation.

Suivant : Copie des données d’une zone de préparation S3