Étape 2. Créer un objet préparé nommé

Exécutez CREATE STAGE pour créer une zone de préparation externe nommée. Une zone de préparation externe fait référence à des fichiers de données stockés dans un compartiment S3. Dans ce cas, nous sommes en train de créer une zone de préparation qui fait référence aux exemples de fichiers de données nécessaires pour effectuer ce tutoriel.

Cette étape est recommandée lorsque vous prévoyez de charger régulièrement des fichiers de données provenant de la même source.

Les exemples suivants créent des zones de préparation externes qui spécifient les formats de fichier que vous avez créés dans l’étape 1. Notez que si vous spécifiez des options de format de fichier (ou un objet de format de fichier nommé) 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 depuis la zone de préparation.

Préparation de fichiers de données CSV

L’exemple suivant crée une zone de préparation externe nommée my_csv_stage. Les valeurs des paramètres qui ne sont pas spécifiées utilisent les valeurs par défaut (DATE_FORMAT = AUTO, COMPRESSION = AUTO, etc.).

CREATE OR REPLACE STAGE my_csv_stage
  FILE_FORMAT = mycsvformat
  URL = 's3://snowflake-docs';

Préparation de fichiers de données JSON

L’exemple suivant crée une zone de préparation externe nommée my_json_stage. Les valeurs des paramètres qui ne sont pas spécifiées utilisent les valeurs par défaut (DATE_FORMAT = AUTO, COMPRESSION = AUTO, etc.).

CREATE OR REPLACE STAGE my_json_stage
  FILE_FORMAT = myjsonformat
  URL = 's3://snowflake-docs';

Note

En utilisation normale, si vous créez une zone de préparation qui pointe vers vos fichiers de données privés, vous référencez une intégration de stockage créée à l’aide de CREATE STORAGE INTEGRATION par un administrateur de compte (c’est-à-dire un utilisateur avec le rôle ACCOUNTADMIN) ou un rôle avec le privilège global CREATE INTEGRATION :

CREATE OR REPLACE STAGE external_stage
  FILE_FORMAT = mycsvformat
  URL = 's3://private-bucket'
  STORAGE_INTEGRATION = myint;

Suivant : Étape 3. Copie de données dans la table cible