NATIVE_DIMENSION

Renvoie le résultat d'une expression SQL BigQuery évaluée par l'ensemble de données sous-jacent.

La fonction NATIVE_DIMENSION vous permet d'écrire du code SQL directement dans un champ Data Studio. Cela est utile pour les fonctions qui ne figurent pas dans la liste des fonctions, mais que votre base de données accepte.

Activer les fonctions natives

Les fonctions natives sont désactivées par défaut et gérées au niveau de la source de données.

Si vous êtes propriétaire d'une source de données BigQuery, vous pouvez activer les fonctions natives pour la source de données en procédant comme suit :

  1. Dans Data Studio, modifiez la source de données.
  2. En haut à droite de l'éditeur de source de données, cliquez sur Fonctions natives.
  3. Dans la boîte de dialogue Fonctions natives, sélectionnez Activé.
  4. Cliquez sur Enregistrer.

Si vous désactivez les fonctions natives, aucun utilisateur ne pourra créer de champs qui en contiennent. Par ailleurs, tous les graphiques existants qui font référence à des champs utilisant des fonctions natives afficheront une erreur.

Exemple d'utilisation

NATIVE_DIMENSION("JSON_VALUE('{"name": "Dana"}','$.name')","STRING")

Syntaxe

NATIVE_DIMENSION( expression, type )

Paramètres

expression : expression à évaluer par l'ensemble de données sous-jacent. Il peut s'agir de n'importe quel code SQL BigQuery valide qui serait placé dans une seule colonne d'une instruction SELECT. L'expression ne peut inclure aucune agrégation.

type : un littéral de type de données. Consultez la section suivante pour connaître les types acceptés par cette fonction.

Types de fonctions NATIVE_DIMENSION

Vous pouvez choisir parmi les types suivants :

Type Données attendues Exemples de rapports
STRING Zéro ou plusieurs lettres, chiffres, caractères ou symboles.

A1B2C3

BOOL

Valeur logique.

true

false

DOUBLE Nombre à virgule flottante. 1,234.56
INT64 Nombre entier. 1,234
DATE Date du calendrier

2020-09-21

DATETIME Date de calendrier avec l'heure 2020-09-21 12:35 PM
GEOGRAPHY

Ensemble de points et de polygones correspondant au type de données GEOGRAPHY BigQuery .

Seules les fonctions BigQuery POINT et POLYGON sont acceptées.

POINT(32 210)

POLYGON((0 0, 2 2, 2 0, 0 0), (2 2, 3 4, 2 4, 2 2))

Si votre expression renvoie un type de données de code temporel tel que le type TIMESTAMP de BigQuery, utilisez la fonction CAST pour la caster vers un type DATETIME. Exemple :

NATIVE_DIMENSION("CAST({ expression } AS DATETIME)", "DATETIME")

Exemples de fonctions NATIVE_DIMENSION

Fonctions JSON en langage SQL

Supposons que vos données incluent un champ users_ages_json dont les valeurs sont mises en forme en tant que charges utiles JSON. Voici un exemple de valeur de ligne pour ce champ :

{"name": "Jakob", "age": "26"}

Utilisez la fonction NATIVE_DIMENSION pour récupérer l'âge à partir du champ users_ages_json à l'aide de la fonction JSON_VALUE de BigQuery :

NATIVE_DIMENSION("JSON_VALUE(user_ages_json, '$.age')","INT64")

Pour cet exemple de valeur de ligne, la NATIVE_DIMENSION fonction renverrait l'âge 26 sous forme d'entier.

Limites des fonctions NATIVE_DIMENSION

Qui peut utiliser des fonctions natives ?

Si les fonctions natives sont activées, les propriétaires et les éditeurs de la source de données peuvent créer des champs avec des fonctions natives dans la source de données.

Les lecteurs de la source de données peuvent utiliser des champs avec des fonctions natives dans les graphiques. En revanche, ils ne peuvent pas créer ni modifier des champs utilisant des fonctions natives.

Champs agrégés

Vous ne pouvez inclure aucun champ agrégé dans le paramètre expression.

Fonctions de fenêtrage

Vous ne pouvez inclure aucune fonction de fenêtrage dans le expression paramètre.

Combinaisons

Vous ne pouvez pas créer de champ avec la NATIVE_DIMENSION fonction dans une source de données combinée.

Toutefois, vous pouvez créer un champ avec cette fonction avant de le combiner, puis l'utiliser dans une combinaison.

Types de données TIMESTAMP

Si votre expression renvoie un type de données de code temporel tel que le type TIMESTAMP de BigQuery, utilisez la fonction CAST pour la caster vers un type DATETIME. Exemple :

NATIVE_DIMENSION("CAST({expression} AS DATETIME)", "DATETIME")