Obtenir la requête

Version 4.0.23.6 (la plus récente)

Récupérer une requête créée par ID

Un objet de requête Looker inclut les différents paramètres qui définissent une requête de base de données qui a été exécutée ou pourrait être exécutée à l'avenir. Ces paramètres incluent le modèle, la vue, les champs, les filtres, les tableaux croisés dynamiques, etc. Les résultats de la requête ne font pas partie de l'objet de requête.

Les objets de requête sont uniques et immuables. Les objets de requête sont créés automatiquement dans Looker lorsque les utilisateurs explorent des données. Looker ne les supprime pas. Ils font partie de l'historique des requêtes. Lorsque vous êtes invité à créer une requête pour un ensemble de paramètres donné, Looker tente d'abord de trouver un objet de requête existant avec des paramètres correspondants, puis ne crée un objet que lorsqu'un objet approprié est introuvable.

Cette méthode "get" permet d'obtenir les détails d'une requête pour un identifiant donné. Consultez les autres méthodes ici pour "créer" et "exécuter" des requêtes.

Notez que certains champs tels que "filter_config" et "vis_config", etc., sont spécifiques à la manière dont l'UI Looker crée des requêtes et des visualisations, et ne sont généralement pas utiles pour l'API. Ils ne sont pas obligatoires lors de la création de requêtes et peuvent généralement être ignorés.

Demande

GET /queries/{query_id}
Type de données
Description
Demande
HTTPRequest
chemin d'accès
Chemin HTTP
Développer la définition HTTPPath...
id_requête
string
ID de la requête
query
Requête HTTP
Développer la définition de la requête HTTP...
champs
string
Champs demandés.

Réponse

200: Requête

Type de données
Description
(objet)
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

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

Examples