Partage via

AFFICHER LES VOLUMES

  • Article

S’applique à : coche marquée oui Databricks SQL coche marquée oui Databricks Runtime 13.3 LTS et versions ultérieures cochée oui Unity Catalog uniquement

Répertorie tous les volumes accessibles à l'utilisateur actuel dans le schéma actuel ou éventuellement spécifié. En outre, la sortie de cette instruction peut être filtrée par un modèle de correspondance facultatif.

Syntaxe

SHOW VOLUMES [ { FROM | IN } schema_name ] [ [ LIKE ] regex_pattern } ]

Paramètres

  • schema_name

    Spécifie le schéma dans lequel les volumes doivent être répertoriés.

  • regex_pattern

    Un STRING littéral avec un modèle d'expression régulière utilisé pour filtrer les résultats de l'instruction.

    • À l’exception des caractères * et |, le modèle fonctionne comme une expression régulière.
    • * seul correspond à 0 ou plusieurs caractères et | est utilisé pour séparer plusieurs expressions régulières différentes, qui peuvent toutes correspondre.
    • Les espaces de début et de fin sont supprimés dans le modèle d’entrée avant le traitement. La correspondance du modèle n’est pas sensible à la casse.

Retours

Un ensemble de résultats avec deux colonnes :

  • database STRING NOT NULL : Le schéma du volume
  • volumeName STRING NOT NULL : Le nom du volume

Exemples

– List all volumes accessible by the caller
> SHOW VOLUMES
  database         volumeName
  ---------------- ----------
  default          my_external_volume
  default          another_volume
  default          foo_volume

– List all volumes under schema `machine_learning`
> SHOW VOLUMES IN machine_learning
  database         volumeName
  ---------------- ----------
  machine_learning bar_volume

– List all volumes whose name starts with 'a'
> SHOW VOLUMES LIKE 'a*'
  database         volumeName
  ---------------- ----------
  default          another_volume