Requête

Récupère les jeux de résultats d’une ou plusieurs tables.

S’applique à :case marquée oui Databricks SQL oui coché Databricks Runtime

Syntaxe

[ common_table_expression ]
  { subquery | set_operator }
  [ ORDER BY clause | { [ DISTRIBUTE BY clause ] [ SORT BY clause ] } | CLUSTER BY clause ]
  [ WINDOW clause ]
  [ LIMIT clause  ]
  [ OFFSET clause ]

subquery
{ SELECT clause |
  VALUES clause |
  ( query ) |
  TABLE [ table_name | view_name ]}

Paramètres

  • expression de table commune

    Les expressions de table communes sont une ou plusieurs requêtes nommées qui peuvent être réutilisées plusieurs fois dans le bloc de requête principal afin d’éviter les calculs répétés ou d’améliorer la lisibilité des requêtes complexes et imbriquées.

  • subquery

    Une des différentes constructions produisant un jeu de résultats intermédiaire.

    • SELECT

      Sous-requête composée d’un modèle SELECT FROM WHERE.

    • VALUES

      A spécifié une table temporaire en ligne.

    • ( query )

      Appel imbriqué d’une requête qui peut contenir des opérateurs de jeu ou des expressions de table communes.

    • TABLE

      Retourne l’intégralité de la table ou de la vue.

      Si la table ou l’affichage est introuvable, Azure Databricks génère une erreur TABLE_OR_VIEW_NOT_FOUND.

  • opérateur_set

    Construction associant des sous-requêtes utilisant des opérateurs UNION, EXCEPT ou INTERSECT.

  • ORDER BY

    Classement des lignes du jeu de résultats complet de la requête. Les lignes de sortie sont triées sur les partitions. Ce paramètre est mutuellement exclusif à SORT BY, CLUSTER BY et DISTRIBUTE BY et ne peut pas être spécifié avec.

  • DISTRIBUTE BY

    Ensemble d’expressions par lequel les lignes de résultats sont repartitionnées. Ce paramètre est mutuellement exclusif à ORDER BY et CLUSTER BY et ne peut pas être spécifié avec.

  • SORT BY

    Ordre selon lequel les lignes sont triées dans chaque partition. Ce paramètre est mutuellement exclusif à ORDER BY et CLUSTER BY et ne peut pas être spécifié avec.

  • CLUSTER BY

    Ensemble d’expressions utilisé pour repartitionner et trier les lignes. L’utilisation de cette clause a le même effet que l’utilisation conjointe de DISTRIBUTE BY et SORT BY.

  • LIMIT

    Nombre maximal de lignes qui peuvent être retournées par une instruction ou une sous-requête. Cette clause est principalement utilisée conjointement avec ORDER BY pour produire un résultat déterministe.

  • OFFSET

    S’applique à :coche marquée oui Databricks SQL coche marquée oui Databricks Runtime 11.3 LTS et versions ultérieures

    Ignore un nombre de lignes retournées par une instruction ou une sous-requête. Cette clause est principalement utilisée conjointement avec LIMIT pour page par le biais d’un jeu de résultats, et avec ORDER BY pour produire un résultat déterministe.

    Notes

    Lors de la pagination d’un jeu de résultats à l’aide de LIMIT et OFFSET, les lignes ignorées sont toujours traitées. Ces lignes sont simplement supprimées du jeu de résultats. La pagination avec cette technique n’est pas recommandée pour les requêtes gourmandes en ressources.

  • WINDOW

    Définit les spécifications de fenêtres nommées pouvant être partagées par plusieurs fonctions de fenêtre dans select_query.