Exécuter la requête asynchrone

Version 4.0.23.6 (la plus récente)

Créer une tâche de requête asynchrone

Crée une tâche de requête (tâche) pour exécuter une requête précédemment créée de manière asynchrone. Renvoie un ID de tâche de requête.

Utilisez query_task(query_task_id) pour vérifier l'état d'exécution de la tâche de requête. Lorsque la tâche affiche "Terminé", utilisez query_task_results(query_task_id) pour récupérer les résultats de la requête.

Demande

POST /query_tasks
Type de données
Description
Demande
HTTPRequest
body
Corps HTTP
Développer la définition HTTPBody...
body
des paramètres de requête.
Développer la définition de "QueryQueryTask"...
peut
objet
Opérations que l'utilisateur actuel peut effectuer sur cet objet
id_requête
string
ID de la requête à exécuter
format_résultats
string
Format de résultat de requête asynchrone souhaité. Les valeurs valides sont "inline_json", "json", "json_detail", "json_fe", "csv", "html", "md", "txt", "xlsx", "gsxml".
source
string
Source de la tâche de requête
deferred
booléen
Créer la tâche, mais différer l'exécution
id_look
string
ID de l'aspect associé à la requête.
id_tableau_de_bord
string
ID du tableau de bord associé à la requê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.
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
largeur_image
integer
OBSOLÈTE. Largeur de rendu pour les formats d'image. Notez que ce paramètre est toujours ignoré par cette méthode.
hauteur_image
integer
OBSOLÈTE. Hauteur de rendu pour les formats d'image. Notez que ce paramètre est toujours ignoré par cette méthode.
champs
string
Champs demandés

Réponse

200: tâche_requête

Type de données
Description
peut
objet
Opérations que l'utilisateur actuel peut effectuer sur cet objet
id
string
Identifiant unique
id_requête
string
ID de la requête
query
Requête
Développer la définition de la requête...
peut
objet
Opérations que l'utilisateur actuel peut effectuer sur cet objet
id
string
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
Générer des liens
booléen
s'il faut ou non générer des liens dans la réponse à la requête.
Forcer la production
booléen
Utilisez des modèles de production pour exécuter la requête (même en mode développeur).
préfixe_chemin
string
Préfixe à utiliser pour les liens d'exploration.
cache
booléen
Utiliser le cache ou non
serveurs_table_calcs
booléen
Permet d'exécuter ou non des calculs de tables sur le serveur
cache_only
booléen
Récupérez tous les résultats du cache, même s'ils ont expiré.
clé_du_cache
string
Clé de cache utilisée pour mettre en cache la requête.
état
string
État de la tâche de requête.
source
string
Source de la tâche de requête.
runtime
nombre
Environnement d'exécution des requêtes précédentes
recompiler_pdts
booléen
Recompilation des PDTS utilisées dans la requête.
source_résultats
string
Source des résultats de la requête.
id_look
string
ID de l'aspect associé à la requête.
id_tableau_de_bord
string
ID du tableau de bord associé à la requête.
format_résultats
string
Format de données des résultats de la requête.

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

409: La ressource existe déjà

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