LIST¶

Pour une zone de préparation¶

LIST { internalStage | externalStage } [ PATTERN = '<regex_pattern>' ]

Où :

internalStage ::=
    @[<namespace>.]<int_stage_name>[/<path>]
  | @[<namespace>.]%<table_name>[/<path>]
  | @~[/<path>]

Copy

externalStage ::=
  @[<namespace>.]<ext_stage_name>[/<path>]

Copy

Pour un clone de référentiel Git¶

LIST repositoryClone [ PATTERN = '<regex_pattern>' ]

Où :

repositoryClone ::=
  @[<namespace>.]<repository_clone>/<path>

Copy

Pour une zone de préparation¶

internalStage | externalStage

Indique l’emplacement où les fichiers de données sont stockés en zone de préparation :

@[namespace.]int_stage_name[/path]	Les fichiers se trouvent dans la zone de préparation interne nommée spécifiée.
@[namespace.]ext_stage_name[/path]	Les fichiers se trouvent dans la zone de préparation externe nommée spécifiée.
@[namespace.]%table_name[/path]	Les fichiers sont mis en zone de préparation pour la table spécifiée.
@~[/path]	Les fichiers sont mis en zone de préparation pour l’utilisateur actuel.

Où :

• namespace est la base de données et/ou le schéma dans lequel réside l’échelon ou la table nommé(e). Il est facultatif si une base de données et un schéma sont actuellement utilisés dans la session. Dans le cas contraire, il est nécessaire.

• path est un chemin facultatif sensible à la casse pour les fichiers de l’emplacement de stockage Cloud (c’est-à-dire que les fichiers ont des noms qui commencent par une chaîne commune) qui limite l’accès à un ensemble de fichiers. Les chemins sont appelés préfixes ou dossiers selon les services de stockage Cloud.

Note

Si le nom ou le chemin de la zone de préparation comprend des espaces ou des caractères spéciaux, il doit être placé entre guillemets simples (par exemple, '@"my stage"' pour une zone de préparation nommée "my stage").

Astuce

La spécification d’un chemin permet à la commande LIST d’avoir une portée, ce qui réduit potentiellement le temps nécessaire à l’exécution de la commande.

Pour un clone de référentiel Git¶

repositoryClone

Spécifie le nom du clone de référentiel et la branche, la balise ou la validation pour laquelle répertorier les fichiers.

@[namespace.]repository_clone/path

Quand les fichiers d’un clone de référentiel Git sont répertoriés, le path est obligatoire et doit commencer par l’un des éléments suivants :

branches/branch_name	Répertorier les fichiers de la branche spécifiée.
tags/tag_name	Répertorier les fichiers de la balise spécifiée.
commits/commit_hash	Répertorier les fichiers de la validation spécifiée par le hachage de validation.

Note

Si le nom ou le chemin du clone du référentiel comprend des espaces ou des caractères spéciaux, il doit être placé entre guillemets simples (exemple : '@"my repository"' pour un référentiel nommé "my repository").

Pour une zone de préparation¶

Pour un clone de référentiel Git¶

Pour une zone de préparation¶

Énumérer tous les fichiers de la zone de préparation de la table mytable :

LIST @%mytable;

Énumérer tous les fichiers dans le chemin path1 de la zone de préparation nommée mystage :

LIST @mystage/path1;

Énumérer les fichiers qui correspondent à une expression régulière (c’est-à-dire tous les noms de fichiers contenant la chaîne data_0) dans la zone de préparation de la table mytable :

LIST @%mytable PATTERN='.*data_0.*';

Énumérer les fichiers dans le chemin /analysis/ de la zone de préparation my_csv_stage qui correspondent à une expression régulière (c’est-à-dire tous les noms de fichiers contenant la chaîne data_0) :

LIST @my_csv_stage/analysis/ PATTERN='.*data_0.*';

Utiliser la forme abrégée de la commande pour lister tous les fichiers de la zone de préparation pour l’utilisateur courant :

LS @~;

Pour un clone de référentiel Git¶

Pour des exemples, voir Voir une liste des fichiers du référentiel.