CREATE EXTERNAL TABLE

Nom de la table à créer, qualifié par un nom de schéma externe. Les tables externes doivent être créées dans un schéma externe. Pour plus d'informations, consultez CREATE EXTERNAL SCHEMA.

La longueur maximale d’un nom de table est de 127 octets ; les noms plus longs sont tronqués à 127 octets. Vous pouvez utiliser UTF -8 caractères multioctets jusqu'à un maximum de quatre octets. Amazon Redshift impose une limite de 9 900 tables par cluster, y compris les tables temporaires définies par l’utilisateur et les tables temporaires créées par Amazon Redshift lors du traitement des requêtes ou de la maintenance du système. Le cas échéant, le nom de la table peut être qualifié avec le nom de la base de données. Dans l’exemple suivant, le nom de base de données est spectrum_db, le nom du schéma externe est spectrum_schema et le nom de la table est test.

create external table spectrum_db.spectrum_schema.test (c1 int)
stored as parquet
location 's3://amzn-s3-demo-bucket/myfolder/';

Si la base de données ou le schéma spécifié n’existe pas, la table n’est pas créée et l’instruction renvoie une erreur. Vous ne pouvez pas créer de tables ni de vues dans les bases de données système template0, template1, padb_harvest ou sys:internal.

Le nom de la table doit être un nom unique pour le schéma spécifié.

Pour plus d’informations sur les noms valides, consultez Noms et identificateurs.

Nom et type de données de chaque colonne en cours de création.

La longueur maximale d’un nom de colonne est de 127 octets ; les noms plus longs sont tronqués à 127 octets. Vous pouvez utiliser UTF -8 caractères multioctets jusqu'à un maximum de quatre octets. Vous ne pouvez pas spécifier de noms de colonne "$path" ou "$size". Pour plus d’informations sur les noms valides, consultez Noms et identificateurs.

Par défaut, Amazon Redshift crée les tables externes avec les pseudo-colonnes $path et $size. Vous pouvez désactiver la création de pseudo-colonnes d’une séance en définissant le paramètre de configuration spectrum_enable_pseudo_columns avec la valeur false. Pour plus d'informations, consultez Pseudocolonnes .

Si les pseudo-colonnes sont activées, le nombre maximal de colonnes que vous pouvez définir dans une seule table est 1 598. Si les pseudo-colonnes ne sont pas activées, le nombre maximal de colonnes que vous pouvez définir dans une seule table est 1 600.

Si vous créez une grande table, assurez-vous que la liste de colonnes ne dépasse pas les limites de largeur de ligne pour les résultats intermédiaires pendant le traitement des charges et des requêtes. Pour de plus amples informations, veuillez consulter Notes d’utilisation.

Pour une commande CREATE EXTERNAL TABLE AS, aucune liste de colonnes n'est requise, car les colonnes sont dérivées de la requête.

Les encodages Types de données suivants sont pris en charge :

En DATE effet, vous pouvez utiliser les formats décrits ci-dessous. Pour les valeurs de mois représentées à l’aide de chiffres, les formats suivants sont pris en charge :

Pour les valeurs de mois représentées à l’aide de l’abréviation de trois lettres, les formats suivants sont pris en charge :

Pour les valeurs d’années qui sont constamment inférieures à 100, l’année est calculée de la manière suivante :

Les valeurs d’horodatage dans les fichiers texte doivent être au format yyyy-mm-dd HH:mm:ss.SSSSSS, comme illustré par la valeur d’horodatage suivante : 2017-05-01 11:30:59.000000.

La longueur d'une VARCHAR colonne est définie en octets et non en caractères. Par exemple, une colonne VARCHAR (12) peut contenir 12 caractères à un octet ou 6 caractères à deux octets. Lorsque vous interrogez une table externe, les résultats sont tronqués pour s’adapter à la taille définie de la colonne sans renvoyer d’erreur. Pour plus d'informations, consultez Stockage et plages.

Pour de meilleures performances, nous vous recommandons de spécifier la plus petite taille de colonne adaptée à vos données. Pour déterminer la taille maximale en octets des valeurs d'une colonne, utilisez la LENGTH fonction OCTET_. L’exemple suivant renvoie la taille maximale des valeurs de la colonne EMAIL.

select max(octet_length(email)) from users;

max
---
 62

Clause qui définit une table partitionnée avec une ou plusieurs colonnes de partition. Un répertoire de données distinct est utilisé pour chaque combinaison spécifiée, ce qui dans certains cas améliore la performance des requêtes. Les colonnes partitionnées n’existent pas au sein même des données de la table. Si la valeur de nom_col est identique à celle d’une colonne de table, une erreur est renvoyée.

Après avoir créé une table partitionnée, modifiez-la à l'aide d'une ADD PARTITION instructionALTER TABLE... pour enregistrer de nouvelles partitions dans le catalogue externe. Lorsque vous ajoutez une partition, vous définissez l’emplacement du sous-dossier sur Amazon S3 qui contient les données de partition.

Par exemple, si la table spectrum.lineitem_part est définie avecPARTITIONED BY (l_shipdate date), exécutez la ALTER TABLE commande suivante pour ajouter une partition.

ALTER TABLE spectrum.lineitem_part ADD PARTITION (l_shipdate='1992-01-29')
LOCATION 's3://spectrum-public/lineitem_partition/l_shipdate=1992-01-29';

Si vous utilisez CREATE EXTERNAL TABLE AS, vous n'avez pas besoin de lancer ALTERTABLE... ADDPARTITION. Amazon Redshift enregistre automatiquement les nouvelles partitions dans le catalogue externe. Amazon Redshift écrit également automatiquement les données correspondantes dans les partitions d’Amazon S3 en fonction de la ou des clés de partition définies dans la table.

Pour afficher les partitions, interrogez la vue système SVV_EXTERNAL_PARTITIONS.

Clause qui spécifie le format des données sous-jacentes. Les valeurs possibles pour format_ligne sont les suivantes :

Spécifiez un seul ASCII caractère pour « délimiteur ». Vous pouvez spécifier des ASCII caractères non imprimables en octal, au format '\ ddd'composé d'un chiffre octal (0—7) allant jusqu'à « \ 177 ». d L'exemple suivant spécifie le caractère BEL (cloche) en octal.

ROW FORMAT DELIMITED FIELDS TERMINATED BY '\007'

S'il ROW FORMAT est omis, le format par défaut est DELIMITED FIELDS TERMINATED BY '\ A' (début du titre) et LINES TERMINATED BY'\n'(nouvelle ligne).

Clause qui spécifie le SERDE format des données sous-jacentes.

S'il ROW FORMAT est omis, le format par défaut est DELIMITED FIELDS TERMINATED BY '\ A' (début du titre) et LINES TERMINATED BY'\n'(nouvelle ligne).

Format des fichiers de données.

Les formats valides sont les suivants :

La commande CREATE EXTERNAL TABLE AS ne prend en charge que deux formats de fichier, TEXTFILE etPARQUET.

Pour INPUTFORMAT etOUTPUTFORMAT, spécifiez un nom de classe, comme le montre l'exemple suivant.

'org.apache.hadoop.mapred.TextInputFormat'

Chemin menant au compartiment Amazon S3 ou au dossier qui contient les fichiers de données ou un fichier manifeste qui contient une liste de chemins d’objets Amazon S3. Les compartiments doivent se trouver dans la même AWS région que le cluster Amazon Redshift. Pour obtenir la liste des AWS régions prises en charge, consultezLimites d'Amazon Redshift Spectrum.

Si le chemin précise un compartiment ou un dossier, par exemple, 's3://amzn-s3-demo-bucket/custdata/', Redshift Spectrum analyse les fichiers qui se trouvent dans le compartiment ou dossier spécifié et dans tous les sous-dossiers. Redshift Spectrum ignore les fichiers masqués ainsi que les fichiers dont le nom commence par un point ou un trait de soulignement.

Si le chemin indique un fichier manifeste, l’argument 's3://bucket/manifest_file' doit explicitement faire référence à un seul fichier, par exemple, 's3://amzn-s3-demo-bucket/manifest.txt'. Il ne peut pas faire référence à un préfixe de clé.

Le manifeste est un fichier texte au JSON format qui répertorie le nom URL de chaque fichier à charger depuis Amazon S3 et la taille du fichier, en octets. URLCela inclut le nom du compartiment et le chemin complet de l'objet du fichier. Les fichiers spécifiés dans le manifeste peuvent se trouver dans différents compartiments, mais tous les compartiments doivent se trouver dans la même AWS région que le cluster Amazon Redshift. Si un fichier est répertorié deux fois, le fichier est chargé deux fois. L'exemple suivant montre le JSON cas d'un manifeste qui charge trois fichiers.

{
  "entries": [
    {"url":"s3://amzn-s3-demo-bucket1/custdata.1", "meta": { "content_length": 5956875 } },
    {"url":"s3://amzn-s3-demo-bucket1/custdata.2", "meta": { "content_length": 5997091 } },
    {"url":"s3://amzn-s3-demo-bucket2/custdata.1", "meta": { "content_length": 5978675 } }
  ]
}

Vous pouvez rendre obligatoire l’inclusion d’un fichier particulier. Pour ce faire, incluez une option mandatory au niveau du fichier dans le manifeste. Lorsque vous interrogez une table externe dont un fichier obligatoire est manquant, l'SELECTinstruction échoue. Assurez-vous que tous les fichiers inclus dans la définition de la table externe sont présents. S’ils ne sont pas tous présents, une erreur apparaît, indiquant le premier fichier obligatoire introuvable. L'exemple suivant montre le nom JSON d'un manifeste dont l'mandatoryoption est définie surtrue.

{
  "entries": [
    {"url":"s3://amzn-s3-demo-bucket1/custdata.1", "mandatory":true, "meta": { "content_length": 5956875 } },
    {"url":"s3://amzn-s3-demo-bucket1/custdata.2", "mandatory":false, "meta": { "content_length": 5997091 } },
    {"url":"s3://amzn-s3-demo-bucket2/custdata.1", "meta": { "content_length": 5978675 } }
  ]
}

Pour référencer des fichiers créés à l'aide du paramètreUNLOAD, vous pouvez utiliser le manifeste créé à l'UNLOADaide du MANIFEST paramètre. Le fichier manifeste est compatible avec un fichier manifeste pour COPYdepuis Amazon S3, mais il n’utilise pas les mêmes clés. Les clés inutilisées sont ignorées.

Clause qui définit la définition de table pour des propriétés de table.