snow dcm preview

Renvoie les lignes de n’importe quelle table, vue, table dynamique.

Syntaxe

snow dcm preview
  <identifier>
  --object <object_identifier>
  --from <from_location>
  --variable <variables>
  --limit <limit>
  --target <target>
  --connection <connection>
  --host <host>
  --port <port>
  --account <account>
  --user <user>
  --password <password>
  --authenticator <authenticator>
  --workload-identity-provider <workload_identity_provider>
  --private-key-file <private_key_file>
  --token <token>
  --token-file-path <token_file_path>
  --database <database>
  --schema <schema>
  --role <role>
  --warehouse <warehouse>
  --temporary-connection
  --mfa-passcode <mfa_passcode>
  --enable-diag
  --diag-log-path <diag_log_path>
  --diag-allowlist-path <diag_allowlist_path>
  --oauth-client-id <oauth_client_id>
  --oauth-client-secret <oauth_client_secret>
  --oauth-authorization-url <oauth_authorization_url>
  --oauth-token-request-url <oauth_token_request_url>
  --oauth-redirect-uri <oauth_redirect_uri>
  --oauth-scope <oauth_scope>
  --oauth-disable-pkce
  --oauth-enable-refresh-tokens
  --oauth-enable-single-use-refresh-tokens
  --client-store-temporary-credential
  --format <format>
  --verbose
  --debug
  --silent
  --enhanced-exit-codes
  --decimal-precision <decimal_precision>

Arguments

identifier

Identificateur de projet DCM. Exemple : MY_DB.MY_SCHEMA.MY_PROJECT. Prend en charge les noms complets (recommandés) ou les noms simples. Si le nom n’est pas complet, la valeur par défaut correspond à la base de données et au schéma de la connexion. Facultatif si --target ou default_target est défini dans le manifeste.

Options

--object TEXT

FQN de la table/vue/table dynamique à prévisualiser.

--from PATH

Chemin d’accès au répertoire local contenant les fichiers de projet DCM. Omettre pour utiliser le répertoire actuel.

--variable, -D TEXT

Variables pour le contexte d’exécution ; par exemple : -D "<key>=<value>".

--limit INTEGER

Nombre maximal de lignes à renvoyer.

--target TEXT

Profil cible de manifest.yml à utiliser. Utilise default_target si non spécifié.

--connection, -c, --environment TEXT

Nom de la connexion, tel que défini dans votre fichier config.toml. Défaut : défaut.

--host TEXT

Adresse de l’hôte pour la connexion. Remplace la valeur spécifiée pour la connexion.

--port INTEGER

Port pour la connexion. Remplace la valeur spécifiée pour la connexion.

--account, --accountname TEXT

Nom attribué à votre compte Snowflake. Remplace la valeur spécifiée pour la connexion.

--user, --username TEXT

Nom d’utilisateur pour se connecter à Snowflake. Remplace la valeur spécifiée pour la connexion.

--password TEXT

Mot de passe Snowflake. Remplace la valeur spécifiée pour la connexion.

--authenticator TEXT

Authentificateur Snowflake. Remplace la valeur spécifiée pour la connexion.

--workload-identity-provider TEXT

Fournisseur d’identité de charge de travail (AWS, AZURE, GCP, OIDC). Remplace la valeur spécifiée pour la connexion.

--private-key-file, --private-key-path TEXT

Chemin du fichier de clé privée Snowflake. Remplace la valeur spécifiée pour la connexion.

--token TEXT

Jeton OAuth à utiliser lors de la connexion à Snowflake.

--token-file-path TEXT

Chemin d’accès au fichier contenant un jeton OAuth à utiliser lors de la connexion à Snowflake.

--database, --dbname TEXT

Base de données à utiliser. Remplace la valeur spécifiée pour la connexion.

--schema, --schemaname TEXT

Schéma de la base de données à utiliser. Remplace la valeur spécifiée pour la connexion.

--role, --rolename TEXT

Rôle à utiliser. Remplace la valeur spécifiée pour la connexion.

--warehouse TEXT

Entrepôt à utiliser. Remplace la valeur spécifiée pour la connexion.

--temporary-connection, -x

Utilise une connexion définie avec les paramètres de la ligne de commande, au lieu de celle définie dans la configuration. Par défaut : False.

--mfa-passcode TEXT

Jeton à utiliser pour l’authentification multifactorielle (MFA)

--enable-diag

Indique s’il faut générer un rapport de diagnostic de la connexion. Par défaut : false.

--diag-log-path TEXT

Chemin d’accès au rapport généré. Il s’agit du répertoire temporaire du système par défaut. Par défaut : <system_temporary_directory>.

--diag-allowlist-path TEXT

Chemin d’accès à un fichier JSON contenant les paramètres de la liste d’autorisations.

--oauth-client-id TEXT

Valeur de l’identifiant du client fourni par le fournisseur d’identité pour l’intégration dans Snowflake.

--oauth-client-secret TEXT

Valeur du secret du client fourni par le fournisseur d’identité pour l’intégration dans Snowflake.

--oauth-authorization-url TEXT

Point de terminaison du fournisseur d’identité fournissant le code d’autorisation au pilote.

--oauth-token-request-url TEXT

Point de terminaison du fournisseur d’identité fournissant les jetons d’accès au pilote.

--oauth-redirect-uri TEXT

URI à utiliser pour la redirection du code d’autorisation.

--oauth-scope TEXT

Champ d’application demandé dans la requête d’autorisation du fournisseur d’identité.

--oauth-disable-pkce

Désactive la clé de preuve pour l’échange de code (PKCE). Par défaut : False.

--oauth-enable-refresh-tokens

Permet une réauthentification silencieuse lorsque le jeton d’accès actuel n’est plus valable. Par défaut : False.

--oauth-enable-single-use-refresh-tokens

Indique s’il faut choisir une sémantique de jeton d’actualisation à usage unique. Par défaut : False.

--client-store-temporary-credential

Enregistrez les identifiants de connexion temporaires.

--format [TABLE|JSON| JSON_EXT|CSV]

Spécifie le format de sortie. Par défaut : TABLE.

--verbose, -v

Affiche les entrées de journal pour les niveaux de journalisation info et supérieurs. Par défaut : false.

--debug

Affiche les entrées de journal pour les niveaux de journalisation debug et supérieurs ; les journaux de débogage contiennent des informations supplémentaires. Par défaut : false.

--silent

Désactive la sortie intermédiaire vers la console. Par défaut : false.

--enhanced-exit-codes

Différenciez les codes d’erreur de sortie en fonction du type d’erreur. Par défaut : false.

--decimal-precision INTEGER

Nombre de décimales à afficher pour les valeurs décimales. Utilise la précision par défaut de Python si non spécifiée. [var env : SNOWFLAKE_DECIMAL_PRECISION].

--help

Affiche le texte d’aide de cette commande.

Notes sur l’utilisation

La commande snow dcm preview renvoie les lignes de n’importe quelle table, vue ou table dynamique définie dans votre objet DCM project. Cette commande est utile pour :

  • Tester vos définitions avant le déploiement

  • Vérifier des données après le déploiement

  • Prévisualiser les vues faisant référence à des noms de tables modélisés

Note

Cette commande importe automatiquement les fichiers SQL source locaux vers une zone de préparation temporaire dans Snowflake afin que leur contenu ait un impact sur le résultat final de l’opération.

L’option :codenowrap:` –objet` est nécessaire et spécifie le nom complet de l’objet DCM project à prévisualiser. Vous pouvez utiliser l’option :codenowrap:` –limite` pour restreindre le nombre de lignes retournées.

Exemples

  • Prévisualiser les données de la table nommée MY_DB .PUBLIC .MY_TABLE pour un objet DCM project, pour lequel le nom du projet est spécifié dans la propriété default_target dans le manifeste :

    snow dcm preview --object MY_DB.PUBLIC.MY_TABLE

  • Prévisualiser les données pour lesquelles le nom du projet est spécifié dans le DEV cible dans le manifeste :

    snow dcm preview --target DEV --object MY_DB.PUBLIC.MY_TABLE

  • Prévisualiser les données d’un objet DCM project avec un nom explicite complet :

    snow dcm preview MY_DB.MY_SCHEMA.MY_PROJECT --object MY_DB.PUBLIC.MY_TABLE

  • Prévisualiser avec une limite de lignes :

    snow dcm preview --object MY_DB.PUBLIC.MY_VIEW --limit 10

  • Prévisualiser avec substitution de variable :

    snow dcm preview --object MY_DB.PUBLIC.MY_VIEW -D "source_table='MY_DB.PUBLIC.SOURCE'"