Partage via

buildschema() (fonction d’agrégation)

  • Article

S’applique à : ✅Microsoft Fabric✅✅

Génère le schéma minimal qui admet toutes les valeurs de DynamicExpr.

Remarque

Cette fonction est utilisée conjointement avec l’opérateur de synthèse.

Syntaxe

buildschema ( DynamicExpr)

En savoir plus sur les conventions de syntaxe.

Paramètres

Nom Type Requise Description
DynamicExpr dynamic ✔️ Expression utilisée pour le calcul d’agrégation.

Retours

Retourne le schéma minimal qui admet toutes les valeurs de DynamicExpr.

Conseil

Si l’entrée est une chaîne JSON, utilisez la fonction parse_json() pour convertir le JSON en valeur dynamique . Sinon, une erreur peut se produire.

Exemple

L’exemple suivant génère un schéma basé sur :

  • {"x":1, "y":3.5}
  • {"x":"somevalue", "z":[1, 2, 3]}
  • {"y":{"w":"zzz"}, "t":["aa", "bb"], "z":["foo"]}
datatable(value: dynamic) [
    dynamic({"x":1, "y":3.5}),
    dynamic({"x":"somevalue", "z":[1, 2, 3]}),
    dynamic({"y":{"w":"zzz"}, "t":["aa", "bb"], "z":["foo"]})
]
| summarize buildschema(value)

Résultats

schema_value
{"x » :["long »,"string"],"y » :["double »,{"w » :"string"}],"z » :{ »indexer :["long »,"string"]},"t » :{ »indexer :"string"}}

Répartition des schémas

Dans le schéma résultant :

  • L’objet racine est un conteneur avec quatre propriétés nommées x, y, zet t.
  • La propriété x est de type long ou de type chaîne.
  • La y de propriété est de type double ou d’un autre conteneur avec une propriété w de type chaîne.
  • La propriété z est un tableau, indiqué par le mot clé indexer, où chaque élément peut être de type long ou de type chaîne.
  • La propriété t est un tableau, indiqué par le mot clé indexer, où chaque élément est une chaîne .
  • Chaque propriété est implicitement facultative et tout tableau peut être vide.

Contenu connexe