Créer une requête

Version 3.1.23.2

Créez une requête.

Cela vous permet de créer une requête que vous pourrez exécuter ultérieurement. Les requêtes Looker sont immuables une fois créées et ne sont pas supprimées. Si vous créez une requête semblable à une requête existante, elle est renvoyée et aucune nouvelle requête n'est générée. Qu'une requête soit créée ou non, vous pouvez utiliser "id" dans la requête renvoyée avec la méthode "run".

Les paramètres de requête sont transmis au format JSON dans le corps de la requête.

Demande

POST /queries
Type de données
Description
Demande
HTTPRequest
body
Corps HTTP
Développer la définition HTTPBody...
body
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
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...
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
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)

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

Python

https://github.com/looker-open-source/sdk-codegen/blob/main/examples/python/query_task.py
https://github.com/looker-open-source/sdk-codegen/blob/main/examples/python/query_task.py
https://github.com/looker-open-source/sdk-codegen/blob/main/python/tests/integration/test_methods.py
https://github.com/looker-open-source/sdk-codegen/blob/main/python/tests/integration/test_methods.py
https://github.com/looker-open-source/sdk-codegen/blob/main/python/tests/integration/test_methods.py
https://github.com/looker-open-source/sdk-codegen/blob/main/python/tests/integration/test_methods.py

Ruby

https://github.com/looker-open-source/sdk-codegen/blob/main/examples/ruby/update_look.rb

Kotlin

https://github.com/looker-open-source/sdk-codegen/blob/main/kotlin/src/test/TestMethods.kt
https://github.com/looker-open-source/sdk-codegen/blob/main/kotlin/src/test/TestMethods.kt
https://github.com/looker-open-source/sdk-codegen/blob/main/kotlin/src/test/TestSmoke.kt

TypeScript

https://github.com/looker-open-source/sdk-codegen/blob/main/packages/sdk-node/test/methods.spec.ts
https://github.com/looker-open-source/sdk-codegen/blob/main/packages/sdk-node/test/methods.spec.ts
https://github.com/looker-open-source/sdk-codegen/blob/main/packages/sdk-node/test/methods.spec.ts

Swift

https://github.com/looker-open-source/sdk-codegen/blob/main/swift/looker/Tests/lookerTests/smokeTests.swift
https://github.com/looker-open-source/sdk-codegen/blob/main/swift/looker/Tests/lookerTests/smokeTests.swift