azdata notebook

S’applique à : Azure Data CLI (azdata)

L’article suivant fournit des informations de référence sur les commandes sql dans l’outil azdata. Pour plus d’informations sur les commandes azdata, consultez azdata reference

Commandes

Commande	Description
azdata notebook view	Afficher un notebook. Option pour arrêter à la première erreur d’exécution d’une cellule.
azdata notebook run	Exécuter un notebook. L’exécution s’arrête à la première erreur.

azdata notebook view

Cette commande peut prendre un fichier de notebook et convertir le markdown, le code et la sortie en un format de terminal couleur.

azdata notebook view --path -p 
                     [--continue-on-error -c]

Exemples

Afficher un notebook. Ceci montre toutes les cellules.

azdata notebook view --path "/home/me/notebooks/demo_notebook.ipynb"

Afficher un notebook. Ceci montre toutes les cellules, sauf si une cellule avec une erreur dans sa sortie est rencontrée. Dans ce cas, la sortie s’arrête.

azdata notebook view --path "/home/me/notebooks/demo_notebook.ipynb" --stop-on-error

Paramètres obligatoires

--path -p

Chemin du notebook à afficher.

Paramètres facultatifs

--continue-on-error -c

Continuer d’afficher d’autres cellules en ignorant les erreurs de cellule trouvées dans la sortie du notebook. Le comportement par défaut est d’arrêter en cas d’erreur. L’arrêt permet de voir plus facilement la première cellule qui a rencontré une erreur.

Arguments globaux

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--output -o

Format de sortie. Valeurs autorisées : json, jsonc, table, tsv. Valeur par défaut : json.

--query -q

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

azdata notebook run

Cette commande crée un répertoire temporaire et y exécute le notebook spécifié comme répertoire de travail.

azdata notebook run --path -p 
                    [--output-path]  
                    
[--output-html]  
                    
[--arguments -a]  
                    
[--interactive -i]  
                    
[--clear -c]  
                    
[--timeout -t]  
                    
[--env -e]

Exemples

Exécuter un notebook.

azdata notebook run --path "/home/me/notebooks/demo_notebook.ipynb"

Paramètres obligatoires

--path -p

Chemin du fichier du notebook à exécuter.

Paramètres facultatifs

--output-path

Chemin du répertoire à utiliser pour la sortie du notebook. Le notebook avec des données de sortie et les fichiers générés par le notebook sont générés relativement à ce répertoire.

--output-html

Indicateur facultatif spécifiant s’il faut également convertir le notebook de sortie au format HTML. Crée un deuxième fichier de sortie.

--arguments -a

Liste facultative des arguments de notebook à injecter dans l’exécution du notebook. Encodé en tant que dictionnaire JSON. Exemple : « {"name":"value", "name2":"value2"} »

--interactive -i

Exécutez un notebook en mode interactif.

--clear -c

En mode interactif, effacez la console avant de restituer une cellule.

--timeout -t

Nombre de secondes à attendre avant la fin de l’exécution. La valeur -1 indique une attente infinie. 600

--env -e

Nom de l’environnement. base

Arguments globaux

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--output -o

Format de sortie. Valeurs autorisées : json, jsonc, table, tsv. Valeur par défaut : json.

--query -q

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

Étapes suivantes

Pour plus d’informations sur les autres commandes azdata, consultez azdata reference.

Pour plus d’informations sur l’installation de l’outil azdata, consultez Installer azdata.