UNLOAD

Une SELECT requête. Les résultats de la requête sont déchargés. Dans la plupart des cas, il est intéressant de décharger les données dans un ordre trié en spécifiant une clause ORDER BY dans la requête. Cette approche économise le temps nécessaire au tri des données lors de leur rechargement.

La requête doit être placée entre guillemets simples comme illustré ci-après :

('select * from venue order by venueid')

('select * from venue where venuestate=''NV''')

Le chemin complet, y compris le nom du compartiment, vers l'emplacement sur Amazon S3 où Amazon Redshift écrit les objets du fichier de sortie, y compris le fichier manifeste s'il MANIFEST est spécifié. Les noms d’objet sont préfixés par name-prefix. Si vous utilisez PARTITION BY, une barre oblique (/) est automatiquement ajoutée à la fin de la valeur name-prefix si nécessaire. Pour plus de sécurité, connectez-vous UNLOAD à Amazon S3 à l'aide d'une HTTPS connexion. Par défaut, UNLOAD écrit un ou plusieurs fichiers par tranche. UNLOADajoute un numéro de tranche et un numéro de pièce au préfixe de nom spécifié comme suit :

<object-path>/<name-prefix><slice-number>_part_<part-number>.

S'MANIFESTil est spécifié, le fichier manifeste est écrit comme suit :

<object_path>/<name_prefix>manifest.

Si cela PARALLEL est spécifiéOFF, les fichiers de données sont écrits comme suit :

<object_path>/<name_prefix><part-number>.

UNLOADcrée automatiquement des fichiers chiffrés à l'aide du chiffrement côté serveur (SSE) d'Amazon S3, y compris le fichier manifeste s'il MANIFEST est utilisé. La COPY commande lit automatiquement les fichiers chiffrés côté serveur lors de l'opération de chargement. Vous pouvez télécharger de manière transparente des fichiers chiffrés côté serveur depuis votre compartiment à l'aide de la console Amazon S3 ou. API Pour plus d’informations, consultez Protection des données à l’aide du chiffrement côté serveur.

Pour utiliser le chiffrement côté client Amazon S3, spécifiez l'ENCRYPTEDoption.

La UNLOAD commande a besoin d'une autorisation pour écrire des données sur Amazon S3. La UNLOAD commande utilise les mêmes paramètres que ceux COPY utilisés pour l'autorisation. Pour plus d'informations, reportez-vous Paramètres d’autorisation à la référence de syntaxe des COPY commandes.

Utilisez le mot clé par défaut pour qu'Amazon Redshift utilise le IAM rôle défini par défaut et associé au cluster lors de l'exécution de la UNLOAD commande.

Utilisez le nom de ressource Amazon (ARN) pour un IAM rôle utilisé par votre cluster pour l'authentification et l'autorisation. Si vous spécifiez IAM _ROLE, vous ne pouvez pas utiliser ACCESS _ KEY _ID et SECRET _ ACCESS _ KEYTOKEN, SESSION _ ouCREDENTIALS. Le IAM _ ROLE peut être enchaîné. Pour plus d'informations, consultez la section Chaining IAM des rôles dans le guide de gestion Amazon Redshift.

Mots-clés pour spécifier le format de déchargement qui remplace le format par défaut.

LorsqueCSV, est déchargé dans un fichier texte au CSV format utilisant une virgule (,) comme séparateur par défaut. Si un champ contient des délimiteurs, des guillemets doubles, des sauts de ligne ou des retours chariot, le champ du fichier déchargé est placé entre des guillemets doubles. Un caractère de guillemets doubles dans un champ de données est échappé par un caractère de guillemets doubles supplémentaires. Quand aucune ligne n’est déchargée, Amazon Redshift peut écrire des objets Amazon S3 vides.

LorsquePARQUET, il est déchargé dans un fichier au format Apache Parquet version 1.0. Par défaut, chaque groupe de lignes est compressé par SNAPPY compression. Pour plus d’informations sur le format Apache Parquet, voir Parquet.

LorsqueJSON, est déchargé dans un JSON fichier, chaque ligne contenant un JSON objet, ce qui représente un enregistrement complet dans le résultat de la requête. Amazon Redshift prend en charge l'écriture imbriquée JSON lorsque le résultat de la requête contient des colonnes. SUPER Pour créer un JSON objet valide, le nom de chaque colonne de la requête doit être unique. Dans le JSON fichier, les valeurs booléennes sont déchargées en tant que t ouf, et les NULL valeurs sont déchargées en tant que. null Quand aucune ligne n’est déchargée, Amazon Redshift n’écrit pas d’objets Amazon S3.

Les mots clés FORMAT et AS sont facultatifs. Vous ne pouvez pas l'utiliser CSV avec FIXEDWIDTH ouADDQUOTES. Vous ne pouvez pas utiliser PARQUET avec DELIMITERFIXEDWIDTH,ADDQUOTES,ESCAPE,, NULL ASHEADER,GZIP,BZIP2, ouZSTD. PARQUETwith n'ENCRYPTEDest pris en charge qu'avec le chiffrement côté serveur avec un AWS Key Management Service clé (SSE-KMS). Vous ne pouvez pas utiliser JSON avec DELIMITERHEADER,FIXEDWIDTH,ADDQUOTES,ESCAPE, ou NULL AS.

Spécifie les clés de partition pour l’opération de déchargement. UNLOADpartitionne automatiquement les fichiers de sortie dans des dossiers de partition en fonction des valeurs des clés de partition, conformément à la convention Apache Hive. Par exemple, un fichier Parquet pour l’année de partition 2019 et le mois de septembre a le préfixe suivant : s3://amzn-s3-demo-bucket/my_prefix/year=2019/month=September/000.parquet.

La valeur de nom_colonne doit être une colonne dans les résultats de requête déchargés.

Si vous spécifiez PARTITION BY avec l'INCLUDEoption, les colonnes de partition ne sont pas supprimées des fichiers déchargés.

Amazon Redshift ne prend pas en charge les littéraux de chaîne dans PARTITION les clauses BY.

Crée un fichier manifeste qui répertorie explicitement les détails des fichiers de données créés par le UNLOAD processus. Le manifeste est un fichier texte au JSON format qui répertorie le nom URL de chaque fichier écrit sur Amazon S3.

Si VERBOSE cette option MANIFEST est spécifiée, le manifeste inclut les informations suivantes :

Vous ne pouvez spécifier VERBOSE que les éléments suivantsMANIFEST.

Le fichier manifeste est écrit sur le même préfixe de chemin Amazon S3 que les fichiers de déchargement au format <object_path_prefix>manifest. Par exemple, si le UNLOAD préfixe de chemin Amazon S3 « s3://amzn-s3-demo-bucket/venue_ » est spécifié, l'emplacement du fichier manifeste est « s3://amzn-s3-demo-bucket/venue_manifest ».

Ajoute une ligne d’en-tête contenant des noms de colonne au début de chaque fichier de sortie. Les options de transformation du texteCSV, telles queDELIMITER,ADDQUOTES, etESCAPE, s'appliquent également à la ligne d'en-tête. Vous ne pouvez pas l'utiliser HEADER avecFIXEDWIDTH.

Spécifie un ASCII caractère unique utilisé pour séparer les champs du fichier de sortie, tel qu'un tube (|), une virgule (,) ou un onglet (\ t). Le délimiteur par défaut pour les fichiers texte est un caractère de barre verticale. Le séparateur par défaut pour les CSV fichiers est une virgule. Le mot-clé AS est facultatif. Vous ne pouvez pas l'utiliser DELIMITER avecFIXEDWIDTH. Si les données contiennent le caractère séparateur, vous devez spécifier l'ESCAPEoption permettant d'échapper au délimiteur ou de l'utiliser ADDQUOTES pour placer les données entre guillemets doubles. Vous pouvez également spécifier un délimiteur qui se ne trouve pas dans les données.

Décharge les données dans un fichier où la largeur de chaque colonne est une longueur fixe, plutôt que séparée par un délimiteur. fixedwidth_spec est une chaîne qui spécifie le nombre de colonnes et leur largeur. Le mot-clé AS est facultatif. Comme elle FIXEDWIDTH ne tronque pas les données, la spécification de chaque colonne de l'UNLOADinstruction doit être au moins aussi longue que la longueur de l'entrée la plus longue de cette colonne. Le format de fixedwidth_spec est présenté ci-dessous :

'colID1:colWidth1,colID2:colWidth2, ...'

Vous ne pouvez pas l'utiliser FIXEDWIDTH avec DELIMITER ouHEADER.

Spécifie que les fichiers de sortie sur Amazon S3 sont chiffrés à l’aide d’un chiffrement côté serveur ou d’un chiffrement côté client Amazon S3. S'il MANIFEST est spécifié, le fichier manifeste est également crypté. Pour de plus amples informations, veuillez consulter Déchargement de fichiers de données chiffrés. Si vous ne spécifiez pas le ENCRYPTED paramètre, crée UNLOAD automatiquement des fichiers chiffrés à l'aide du chiffrement côté serveur Amazon S3 avec AWS-clés de chiffrement gérées (SSE-S3).

En effetENCRYPTED, vous souhaiterez peut-être effectuer un déchargement sur Amazon S3 à l'aide d'un chiffrement côté serveur avec un AWS KMS clé (SSE-KMS). Le cas échéant, utilisez le paramètre KMS_KEY_ID pour fournir l’ID de clé. Vous ne pouvez pas utiliser le CREDENTIALS paramètre avec le paramètre KMS _ KEY _ID. Si vous exécutez une UNLOAD commande pour des données à l'aide de KMS _ KEY _ID, vous pouvez ensuite effectuer une COPY opération pour les mêmes données sans spécifier de clé.

Pour décharger sur Amazon S3 à l’aide d’un chiffrement côté client avec une clé symétrique fournie par le client, spécifiez la clé de l’une des deux manières suivantes. Pour fournir la clé, utilisez le paramètre MASTER_SYMMETRIC_KEY ou la partie master_symmetric_key d’une chaîne d’informations d’identification CREDENTIALS. Si vous déchargez des données à l'aide d'une clé symétrique racine, assurez-vous de fournir la même clé lorsque vous effectuez une COPY opération sur les données chiffrées.

UNLOADne prend pas en charge le chiffrement côté serveur Amazon S3 avec une clé fournie par le client (-C). SSE

Si elle ENCRYPTED AUTO est utilisée, la UNLOAD commande récupère la valeur par défaut AWS KMS clé de chiffrement sur la propriété du compartiment Amazon S3 cible et chiffre les fichiers écrits sur Amazon S3 avec AWS KMS clé. Si le bucket ne possède pas la valeur par défaut AWS KMS clé de chiffrement, crée UNLOAD automatiquement des fichiers chiffrés à l'aide du chiffrement côté serveur Amazon Redshift avec AWS-clés de chiffrement gérées (SSE-S3). Vous ne pouvez pas utiliser cette option avec KMS _ KEY _ID, _ MASTER SYMMETRIC _ ou contenant KEY CREDENTIALS master_symmetric_key.

Spécifie l'ID de clé pour un AWS Key Management Service (AWS KMS) clé à utiliser pour chiffrer les fichiers de données sur Amazon S3. Pour plus d'informations, voir Qu'est-ce que AWS Key Management Service? Si vous spécifiez KMS _ KEY _ID, vous devez également spécifier le ENCRYPTED paramètre. Si vous spécifiez KMS _ KEY _ID, vous ne pouvez pas vous authentifier à l'aide du CREDENTIALS paramètre. Utilisez IAM_ROLE ou ACCESS_KEY_ID and SECRET_ACCESS_KEY à la place.

La clé symétrique racine à utiliser pour chiffrer les fichiers de données sur Amazon S3. Si vous spécifiez MASTER SYMMETRIC _ _KEY, vous devez également spécifier le ENCRYPTED paramètre. Vous ne pouvez pas utiliser MASTER _ SYMMETRIC _ KEY avec le CREDENTIALS paramètre. Pour de plus amples informations, veuillez consulter Chargement de fichiers de données chiffrés à partir d’Amazon S3.

Décharge les données sur un ou plusieurs fichiers compressé bzip2 par tranche. Chaque fichier résultant est ajouté avec une extension .bz2.

Décharge les données sur un ou plusieurs fichiers compressé gzip par tranche. Chaque fichier résultant est ajouté avec une extension .gz.

Décharge les données sur un ou plusieurs fichiers compressé Zstandard par tranche. Chaque fichier résultant est ajouté avec une extension .zst.

Place entre guillemets chaque champ de données déchargées, de telle sorte qu’Amazon Redshift puisse décharger les valeurs de données qui contiennent le délimiteur lui-même. Par exemple, si le délimiteur est une virgule, vous pouvez décharger et recharger les données suivantes avec succès :

 "1","Hello, World" 

Sans les guillemets ajoutés, la chaîne Hello, World serait analysée comme deux champs distincts.

Certains formats de sortie ne sont pas pris en chargeADDQUOTES.

Si vous utilisezADDQUOTES, vous devez spécifier REMOVEQUOTES dans le COPY si vous rechargez les données.

Spécifie une chaîne qui représente une valeur null dans les fichiers de déchargement. Si cette option est utilisée, tous les fichiers de sortie contiennent la chaîne spécifiée à la place des valeurs null trouvées dans les données sélectionnées. Si cette option n’est pas spécifiée, les valeurs null sont déchargées en tant que :

Si une chaîne nulle a été spécifiée pour un déchargement de largeur fixe et que la largeur d’une colonne de sortie est inférieure à celle de la chaîne nulle, le comportement est le suivant :

Contrairement aux autres types de données où une chaîne définie par l'utilisateur représente une valeur nulle, Amazon Redshift exporte SUPER les colonnes de données en utilisant JSON le format et les représente comme nulle, conformément au format. JSON Par conséquent, SUPER les colonnes de données ignorent l'option NULL [AS] utilisée dans UNLOAD les commandes.

Pour CHAR et les VARCHAR colonnes des fichiers de déchargement délimités, un caractère d'échappement (\) est placé avant chaque occurrence des caractères suivants :

Par défaut, UNLOAD échoue s'il trouve des fichiers qu'il est susceptible de remplacer. S'il ALLOWOVERWRITE est spécifié, il UNLOAD remplace les fichiers existants, y compris le fichier manifeste.

L'CLEANPATHoption supprime les fichiers existants situés dans le chemin Amazon S3 spécifié dans la clause TO avant de les décharger vers l'emplacement spécifié.

Si vous incluez la clause PARTITION BY, les fichiers existants sont supprimés uniquement des dossiers de partition pour recevoir les nouveaux fichiers générés par l'UNLOADopération.

Vous devez bénéficier d’une autorisation s3:DeleteObject sur le compartiment Amazon S3. Pour obtenir des informations, consultez Politiques et autorisations dans Amazon S3 dans le Guide de l’utilisateur Amazon Simple Storage Service. Les fichiers que vous supprimez à l'aide de CLEANPATH cette option sont définitivement supprimés et ne peuvent pas être récupérés. Si la gestion des versions est activée dans le compartiment Amazon S3 cible, UNLOAD CLEANPATH cette option permet de ne pas supprimer les versions précédentes des fichiers.

Vous ne pouvez pas spécifier l'CLEANPATHoption si vous la ALLOWOVERWRITE spécifiez.

Par défaut, UNLOAD écrit les données en parallèle dans plusieurs fichiers, en fonction du nombre de tranches du cluster. L'option par défaut est ON ouTRUE. If PARALLEL is OFF orFALSE, UNLOAD écrit dans un ou plusieurs fichiers de données en série, triés absolument conformément à la clause ORDER BY, si elle est utilisée. La taille maximale d’un fichier de données est de 6,2 Go. Ainsi, par exemple, si vous déchargez 13,4 Go de données, UNLOAD créez les trois fichiers suivants.

s3://amzn-s3-demo-bucket/key000    6.2 GB
s3://amzn-s3-demo-bucket/key001    6.2 GB
s3://amzn-s3-demo-bucket/key002    1.0 GB

Spécifie la taille maximale des fichiers UNLOAD créés dans Amazon S3. Spécifiez une valeur décimale comprise entre 5 Mo et 6,2 Go. Le mot-clé AS est facultatif. L’unité par défaut est les Mo. Si MAXFILESIZE ce n'est pas le cas, la taille de fichier maximale par défaut est de 6,2 Go. La taille du fichier manifeste, s'il est utilisé, n'est pas affectée parMAXFILESIZE.

Spécifie la taille des groupes de lignes. Le choix d’une taille supérieure peut réduire le nombre de groupes de lignes, réduisant ainsi la quantité de communication réseau. Spécifiez une valeur d’entier comprise entre 32 Mo et 128 Mo. Le mot-clé AS est facultatif. L’unité par défaut est les Mo.

Si ROWGROUPSIZE ce n'est pas le cas, la taille par défaut est de 32 Mo. Pour utiliser ce paramètre, le format de stockage doit être Parquet et le type de nœud doit être ra3.4xlarge, ra3.16xlarge ou dc2.8xlarge.

Spécifie le Région AWS où se trouve le compartiment Amazon S3 cible. REGIONest requis UNLOAD pour un compartiment Amazon S3 qui ne se trouve pas dans le même compartiment Région AWS en tant que base de données Amazon Redshift.

La valeur de aws_region doit correspondre à AWS Région répertoriée dans le tableau des régions et points de terminaison Amazon Redshift dans le Références générales AWS.

Par défaut, UNLOAD suppose que le compartiment Amazon S3 cible se trouve dans le même Région AWS en tant que base de données Amazon Redshift.

Spécifie l’extension de fichier à ajouter aux noms des fichiers déchargés. Amazon Redshift n’effectuant aucune validation, vous devez vérifier que l’extension de fichier spécifiée est correcte. Si vous utilisez une méthode de compression telle queGZIP, vous devez toujours la spécifier .gz dans le paramètre d'extension. Si vous n’indiquez pas d’extension, Amazon Redshift n’ajoute rien au nom de fichier. Si vous spécifiez une méthode de compression sans indiquer d’extension, Amazon Redshift ajoute uniquement l’extension de la méthode de compression au nom de fichier.