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

Une zone de préparation indique où les fichiers de données sont stockés (c’est-à-dire « préparés ») afin que les données contenues dans les fichiers puissent être chargées dans une table.

Dans ce chapitre :

Les données peuvent être chargées directement à partir de fichiers dans un conteneur Azure spécifié ou dans un chemin de « dossier » Azure (comme un préfixe de valeur clé). Si le chemin se termine par /, tous les objets du dossier Azure correspondant sont chargés.

Zones de préparation externes

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

  • Le conteneur Azure où les fichiers sont mis en zone de préparation.

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

  • Une clé de chiffrement (si les fichiers dans le conteneur 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. Pour les instructions de création d’une zone de préparation externe, voir Créer une zone de préparation externe ci-dessous.

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

Vous pouvez créer une zone de préparation externe nommée en utilisant SQL ou l’interface Web.

Note

Vous devez utiliser un rôle qui bénéficie ou hérite du privilège USAGE sur la base de données et le schéma qui stockent la zone de préparation et du privilège CREATE STAGE sur le schéma.

Reportez-vous à Exigences en matière de contrôle d’accès pour CREATE STAGE.

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

Utilisez la commande CREATE STAGE pour créer un zone de préparation externe.

L’exemple suivant crée une zone de préparation externe nommée my_azure_stage. L’instruction CREATE inclut l’intégration de stockage azure_int qui a été créée dans Configuration d’un conteneur Azure pour le chargement de données pour accéder au conteneur Azure container1 dans le compte myaccount.

Les fichiers de données sont stockés dans le chemin load/files/. La zone de préparation fait référence à un objet de format de fichier nommé my_csv_format, qui décrit les données des fichiers stockés dans le chemin :

CREATE STAGE my_azure_stage
  STORAGE_INTEGRATION = azure_int
  URL = 'azure://myaccount.blob.core.windows.net/mycontainer/load/files/'
  FILE_FORMAT = my_csv_format;
Copy

Note

Utilisez le point de terminaison blob.core.windows.net pour tous les types de comptes de stockage Azure Blob pris en charge, dont Data Lake Storage Gen2.

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. Pour plus d’informations sur les objets et les options de format de fichier, voir CREATE FILE FORMAT.

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

Pour utiliser Snowsight afin de créer une zone de préparation externe nommée, procédez comme suit :

  1. Connectez-vous à Snowsight.

  2. Dans le menu de navigation, sélectionnez Data » Databases.

  3. Sélectionnez la base de données et le schéma dans lesquels vous souhaitez créer une zone de préparation.

  4. Sélectionnez Create » Stage.

  5. Sélectionnez le service de stockage Cloud pris en charge où se trouvent vos fichiers.

  6. Entrez un Stage Name.

  7. Saisissez l”URL de votre emplacement de stockage externe dans le Cloud.

  8. Si votre stockage externe n’est pas public, activez Authentication et entrez vos détails. Pour plus d’informations, reportez-vous à CREATE STAGE.

  9. Vous pouvez également désélectionner Directory table. Les tables de répertoire permettent de voir les fichiers sur la zone de préparation, mais elles nécessitent un entrepôt et ont donc un coût. Vous pouvez choisir de désélectionner cette option pour l’instant et d’activer une table de répertoire ultérieurement.

    Si vous activez Directory table, sélectionnez éventuellement Enable auto-refresh et sélectionnez votre notification d’événement ou votre intégration de notification pour actualiser automatiquement la table de répertoire lorsque des fichiers sont ajoutés ou supprimés. Pour en savoir plus, voir Actualisation automatique des métadonnées des tables de répertoire.

  10. Si vos fichiers sont cryptés, activez Encryption et entrez vos détails.

  11. Il est possible de développer SQL Preview pour afficher une instruction SQL générée. Pour spécifier des options supplémentaires pour votre zone de préparation telle que AUTO_REFRESH, vous pouvez ouvrir cet aperçu SQL dans une feuille de calcul.

  12. Sélectionnez Create.

Création d’une zone de préparation externe avec la console classique

Sélectionnez Databases Onglet Bases de données » <nom_bd> » Stages.

Suivant : Copie de données à partir d’une zone de préparation Azure