Requête

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

S’applique à : Databricks SQL 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.

    • table_name

      Identifie la table à retourner.

    • view_name

      Identifie l’affichage à retourner.

    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 à : Databricks SQL Databricks Runtime 11.3 LTS et ultérieur

  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.

Articles connexes

• CLUSTER BY, clause
• Expression de table commune (CTE)
• DISTRIBUTE BY, clause
• GROUP BY, clause
• HAVING, clause
• Indicateurs
• VALUES, clause
• JOIN
• LATERAL VIEW, clause
• LIMIT, clause
• Clause ORDER BY
• PIVOT, clause
• Set operator
• SORT BY, clause
• Informations de référence du tableau
• Clause TABLESAMPLE
• Fonction table (TVF)
• Clause UNPIVOT
• Clause WATERMARK
• Clause WHERE
• WINDOW, clause
• Fonctions Windows