Exécuter une requête intégrée

Version 3.1.23.2

Exécute la requête spécifiée dans le corps publié.

Cela permet d'exécuter une requête définie dans JSON dans le corps publié. Cela permet d'associer les deux actions de publication et d'exécution d'une requête en une seule étape.

Voici un exemple de corps au format JSON:

{
  "model":"thelook",
  "view":"inventory_items",
  "fields":["category.name","inventory_items.days_in_inventory_tier","products.count"],
  "filters":{"category.name":"socks"},
  "sorts":["products.count desc 0"],
  "limit":"500",
  "query_timezone":"America/Los_Angeles"
}

Lorsque vous utilisez le SDK Ruby, ce code est transmis en tant que hachage Ruby, comme suit:

{
 :model=>"thelook",
 :view=>"inventory_items",
 :fields=>
  ["category.name",
   "inventory_items.days_in_inventory_tier",
   "products.count"],
 :filters=>{:"category.name"=>"socks"},
 :sorts=>["products.count desc 0"],
 :limit=>"500",
 :query_timezone=>"America/Los_Angeles",
}

Cette commande renvoie le résultat de l'exécution de la requête au format spécifié par le paramètre "result_format".

Formats compatibles :

format_résultats Description
json JSON brut
détail_json Données de ligne et métadonnées décrivant les champs, les tableaux croisés dynamiques, les valeurs de calcul de tableau et d'autres aspects de la requête
csv Valeurs séparées par une virgule avec un en-tête
txt Valeurs séparées par des tabulations, avec un en-tête
html HTML simple
md Markdown simple
xlsx Feuille de calcul MS Excel
sql Renvoie le code SQL généré au lieu d'exécuter la requête.
png Image PNG de la visualisation de la requête
jpg Image JPG de la visualisation de la requête

Demande

POST /queries/run/{result_format}
Type de données
Description
Demande
HTTPRequest
chemin d'accès
Chemin HTTP
Développer la définition HTTPPath...
format_résultats
string
Format du résultat
body
Corps HTTP
Développer la définition HTTPBody...
body
requête intégrée
Développer la définition de la requête...
peut
objet
Opérations que l'utilisateur actuel peut effectuer sur cet objet
id
integer
Identifiant unique
modèle
string
Modèle
vue
string
Explorer le nom
champs
chaîne[]
tableau croisé dynamique
chaîne[]
remplir_champs
chaîne[]
filtres
objet
Filtres
expression_de_filtre
string
Expression de filtre
tri
chaîne[]
limite
string
Limite
limite_colonne
string
Nombre maximal de colonnes
total
booléen
Total
ligne_total
string
Total brut
sous-totaux
chaîne[]
vis_config
objet
Propriétés de configuration de la visualisation. Ces propriétés sont généralement opaques et diffèrent en fonction du type de visualisation utilisé. Il n'existe aucun ensemble spécifié de clés. Les valeurs peuvent correspondre à n'importe quel type compatible avec JSON. Une clé "type" avec une valeur de chaîne est souvent présente et permet à Looker de déterminer la visualisation à présenter. Les visualisations ignorent les propriétés vis_config inconnues.
config_filtre
objet
Le champ filter_config représente l'état de l'interface utilisateur du filtre sur la page d'exploration pour une requête donnée. Lorsque vous exécutez une requête via l'interface utilisateur de Looker, ce paramètre est prioritaire sur les "filtres". Lorsque vous créez ou modifiez une requête existante, vous devez définir la valeur "filter_config" sur "null". Si vous définissez une autre valeur, vous risquez d'obtenir un comportement de filtrage inattendu. Le format doit être considéré comme opaque.
sections_ui_visibles
string
Sections d'interface utilisateur visibles
limace
string
Slug
champs_dynamiques
string
Champs dynamiques
client_id
string
ID client: permet de générer des URL d'exploration raccourcies. S'il est défini par le client, il doit s'agir d'une chaîne alphanumérique unique de 22 caractères. Sinon, une seule URL sera générée.
URL_partage
string
Partager l'URL
URL_partage_étendu
string
URL de partage agrandie
url
string
URL étendue
requête_fuseau horaire
string
Requête Fuseau horaire
has_table_calculations
booléen
Contient des calculs de tables
runtime
nombre
(OBSOLÈTE) Environnement d'exécution (obsolète)
query
Requête HTTP
Développer la définition de la requête HTTP...
limite
integer
Nombre maximal de lignes (peut remplacer la limite dans la requête enregistrée).
Appliquer le format
booléen
Appliquer la mise en forme spécifiée par le modèle à chaque résultat.
appliquer_vis
booléen
Appliquez des options de visualisation aux résultats.
cache
booléen
Récupère les résultats du cache, le cas échéant.
largeur_image
integer
Largeur de rendu pour les formats d'image.
hauteur_image
integer
Hauteur de rendu pour les formats d'image.
générer_liens_drill
booléen
Générez des liens d'exploration (applicable uniquement au format "json_detail").
Forcer la production
booléen
Forcer l'utilisation des modèles de production, même si l'utilisateur est en mode développement. Notez que l'option "false" ne garantit pas l'utilisation de modèles de développement.
cache_only
booléen
Récupérez tous les résultats du cache, même s'ils ont expiré.
préfixe_chemin
string
Préfixe à utiliser pour les liens d'analyse détaillée (encodés en URL).
recompiler_pdts
booléen
Recompilation des PDTS utilisées dans la requête.
serveurs_table_calcs
booléen
Calculer les tables sur les résultats des requêtes

Réponse

200: Résultat de la requête

Type de données
Description
(chaîne)
string

400 Bad Request

Type de données
Description
(objet)
Message
string
Infos sur l'erreur
documentation_url
string
Lien vers la documentation

404: introuvable

Type de données
Description
(objet)
Message
string
Infos sur l'erreur
documentation_url
string
Lien vers la documentation

422: Erreur de validation

Type de données
Description
(objet)
Message
string
Infos sur l'erreur
Développer la définition de ValidationErrorDetail...
champ
string
Champ comportant une erreur
code
string
Code d'erreur
Message
string
Message d'information sur l'erreur
documentation_url
string
Lien vers la documentation
documentation_url
string
Lien vers la documentation

429 : Too Many Requests

Type de données
Description
(objet)
Message
string
Infos sur l'erreur
documentation_url
string
Lien vers la documentation

Examples