Créer une connexion

Version 4.0.23.2

Crée une connexion à l'aide de la configuration spécifiée.

Demande

POST /connections
Type de données
Description
Demande
HTTPRequest
body
Corps HTTP
Développer la définition HTTPBody...
body
Connexion
Développer la définition de DBConnection...
peut
objet
Opérations que l'utilisateur actuel peut effectuer sur cet objet
name
string
Nom de la connexion. Également utilisé comme identifiant unique
dialecte
Détails du dialecte SQL (lecture seule)
extraits
pdts_enabled
booléen
Vrai si les tables dérivées persistantes sont activées sur cette connexion
hôte
string
Nom ou adresse du serveur, ou chaîne "localhost" en cas de connexion sur un tunnel SSH.
port
string
Numéro de port sur le serveur. Si la connexion passe par un tunnel SSH, le port local associé au tunnel SSH.
nom d'utilisateur
string
Nom d'utilisateur pour l'authentification du serveur
mot de passe
string
(Écriture seule) Mot de passe pour l'authentification du serveur
utilise_oauth
booléen
Indique si la connexion utilise OAuth pour l'authentification.
certificat
string
(Écriture seule) Corps de certificat encodé en base64 pour l'authentification du serveur (si approprié pour le dialecte).
type_de_fichier
string
(Écriture seule) Type de fichier de clé de certificat : .json ou .p12
base de données
string
Nom de la base de données
db_fuseau horaire
string
Fuseau horaire de la base de données
requête_fuseau horaire
string
Fuseau horaire à utiliser dans les requêtes
schema
string
Nom du Scheme
max_connections
integer
Nombre maximal de connexions simultanées à utiliser
Facturation_gigaoctets_max
string
Taille maximale de la requête en Go (BigQuery uniquement, peut être un nom d'attribut utilisateur)
ssl
booléen
Utiliser le protocole SSL/TLS lors de la connexion au serveur
vérifier_ssl
booléen
Vérifier le protocole SSL
tmp_db_name (nom de la tmp_db)
string
Nom de la base de données temporaire (si utilisée)
jdbc_additional_params
string
Paramètres supplémentaires à ajouter à la chaîne de connexion JDBC
pool_timeout
integer
Délai d'expiration du pool de connexions, en secondes
dialecte
string
(Lecture/Écriture) Nom du dialecte SQL
liens_data_studio_support
booléen
La connexion aux bases de données permet d'explorer des données dans Studio
créé le
string
Date de création de cette connexion
user_id
string
ID de l'utilisateur qui a modifié cette configuration de connexion pour la dernière fois
exemple
booléen
S'agit-il d'un exemple de connexion ?
identifiants_utilisateur_db
booléen
(Fonctionnalité à accès limité) Les identifiants de la base de données sont activés par utilisateur. L'activation supprimera le nom d'utilisateur et le mot de passe précédemment définis
user_attribute_fields
chaîne[]
Maintenance_cron
string
Chaîne Cron spécifiant quand effectuer la maintenance (par exemple, les vérifications et les suppressions de déclencheurs PDT)
dernière_génération
string
Horodatage Unix au début du processus de vérification du déclencheur PDT terminé
Dernière_retrait
string
Horodatage Unix au début du dernier processus de PDT terminé
sql_runner_precache_tables
booléen
Effectuer une mise en cache préalable des tables dans l'exécuteur SQL
écriture_sql_avec_schéma_info
booléen
Télécharger un schéma d'informations pour l'écriture SQL
after_connect_statements
string
Instructions SQL (séparées par un point-virgule) à émettre après la connexion à la base de données. Nécessite la fonctionnalité de licence "custom_after_connect_statements"
ppd_context_override
db_connection_override pour cette connexion dans le contexte de maintenance "pdt"
géré
booléen
Cette connexion est-elle créée et gérée par Looker ?
port_local_personnalisé
integer
Ce champ ne s'applique qu'aux connexions via un tunnel SSH. La valeur de ce champ correspond au port local associé au tunnel SSH s'il est configuré manuellement. Sinon, saisissez la valeur NULL ou excluez ce champ.
id_tunnel
string
ID du tunnel SSH utilisé par cette connexion
utilise_ntn
booléen
Activer les connexions TNS (Transparent Network Substrate)
simultanéité pdt
integer
Nombre maximal de threads à utiliser pour créer des tables dérivées persistantes en parallèle
désactiver le commentaire de contexte
booléen
Lorsque "disable_context_comment" est défini sur "true", le commentaire n'est pas ajouté à SQL.
ID_application_oauth
string
Application OAuth externe à utiliser pour l'authentification auprès de la base de données
Toujours recompiler_échecs
booléen
Lorsque la valeur est "true", des tables dérivées persistantes d'erreur sont relancées à chaque cycle de régénération
estimation_coût
booléen
Lorsque la valeur est "true", l'estimation du coût de la requête s'affiche dans l'exploration.
pdt_api_control_enabled
booléen
Les générations de tables dérivées persistantes basées sur cette connexion peuvent être lancées et annulées via l'API.

Réponse

200: Connexion

Type de données
Description
(objet)
peut
objet
Opérations que l'utilisateur actuel peut effectuer sur cet objet
name
string
Nom de la connexion. Également utilisé comme identifiant unique
dialecte
Détails du dialecte SQL (lecture seule)
Développer la définition du dialecte...
name
string
Nom du dialecte
label
string
Libellé de la connexion lisible par l'utilisateur
aide_estimation_coût
booléen
Indique si le dialecte prend en charge les estimations de coûts des requêtes
style_estimation_coût
string
Comment le dialecte gère l'estimation des coûts
index_tableau_persistant
string
Colonnes d'index de PDT
Clés de tri persistantes
string
Colonnes de clé de tri des PDT
table_distincte
string
Colonne de dispersion des PDT
prend_en charge
booléen
Résultats sportifs en streaming
auto_run_sql_runner_snippets
booléen
Les extraits de l'exécuteur SQL doivent-ils être exécutés automatiquement ?
test_connexion
chaîne[]
aide_inducteur
booléen
est compatible avec l'inducteur (c'est-à-dire générer à partir de SQL) ;
support_multiple_databases
booléen
Plusieurs bases de données sont-elles accessibles via une connexion via ce dialecte ?
prend en charge les tables_dérivées_continues
booléen
Indique si le dialecte permet à Looker de créer des tables dérivées persistantes
has_ssl_support
booléen
La base de données permet-elle explicitement la compatibilité SSL du client via la chaîne JDBC ?
extraits
Développer la définition de l'extrait...
name
string
Nom de l'extrait
label
string
Libellé de l'extrait
sql
string
Texte SQL de l'extrait
pdts_enabled
booléen
Vrai si les tables dérivées persistantes sont activées sur cette connexion
hôte
string
Nom ou adresse du serveur, ou chaîne "localhost" en cas de connexion sur un tunnel SSH.
port
string
Numéro de port sur le serveur. Si la connexion passe par un tunnel SSH, le port local associé au tunnel SSH.
nom d'utilisateur
string
Nom d'utilisateur pour l'authentification du serveur
mot de passe
string
(Écriture seule) Mot de passe pour l'authentification du serveur
utilise_oauth
booléen
Indique si la connexion utilise OAuth pour l'authentification.
certificat
string
(Écriture seule) Corps de certificat encodé en base64 pour l'authentification du serveur (si approprié pour le dialecte).
type_de_fichier
string
(Écriture seule) Type de fichier de clé de certificat : .json ou .p12
base de données
string
Nom de la base de données
db_fuseau horaire
string
Fuseau horaire de la base de données
requête_fuseau horaire
string
Fuseau horaire à utiliser dans les requêtes
schema
string
Nom du Scheme
max_connections
integer
Nombre maximal de connexions simultanées à utiliser
Facturation_gigaoctets_max
string
Taille maximale de la requête en Go (BigQuery uniquement, peut être un nom d'attribut utilisateur)
ssl
booléen
Utiliser le protocole SSL/TLS lors de la connexion au serveur
vérifier_ssl
booléen
Vérifier le protocole SSL
tmp_db_name (nom de la tmp_db)
string
Nom de la base de données temporaire (si utilisée)
jdbc_additional_params
string
Paramètres supplémentaires à ajouter à la chaîne de connexion JDBC
pool_timeout
integer
Délai d'expiration du pool de connexions, en secondes
dialecte
string
(Lecture/Écriture) Nom du dialecte SQL
liens_data_studio_support
booléen
La connexion aux bases de données permet d'explorer des données dans Studio
créé le
string
Date de création de cette connexion
user_id
string
ID de l'utilisateur qui a modifié cette configuration de connexion pour la dernière fois
exemple
booléen
S'agit-il d'un exemple de connexion ?
identifiants_utilisateur_db
booléen
(Fonctionnalité à accès limité) Les identifiants de la base de données sont activés par utilisateur. L'activation supprimera le nom d'utilisateur et le mot de passe précédemment définis
user_attribute_fields
chaîne[]
Maintenance_cron
string
Chaîne Cron spécifiant quand effectuer la maintenance (par exemple, les vérifications et les suppressions de déclencheurs PDT)
dernière_génération
string
Horodatage Unix au début du processus de vérification du déclencheur PDT terminé
Dernière_retrait
string
Horodatage Unix au début du dernier processus de PDT terminé
sql_runner_precache_tables
booléen
Effectuer une mise en cache préalable des tables dans l'exécuteur SQL
écriture_sql_avec_schéma_info
booléen
Télécharger un schéma d'informations pour l'écriture SQL
after_connect_statements
string
Instructions SQL (séparées par un point-virgule) à émettre après la connexion à la base de données. Nécessite la fonctionnalité de licence "custom_after_connect_statements"
ppd_context_override
db_connection_override pour cette connexion dans le contexte de maintenance "pdt"
Développer la définition DBConnectionOverride...
context
string
Contexte dans lequel ignorer (pdt est la seule valeur autorisée)
hôte
string
Nom de l'hôte/adresse du serveur
port
string
Numéro de port sur le serveur
nom d'utilisateur
string
Nom d'utilisateur pour l'authentification du serveur
mot de passe
string
(Écriture seule) Mot de passe pour l'authentification du serveur
a_mot_de_passe
booléen
Indique si le mot de passe est ignoré dans ce contexte.
certificat
string
(Écriture seule) Corps de certificat encodé en base64 pour l'authentification du serveur (si approprié pour le dialecte).
type_de_fichier
string
(Écriture seule) Type de fichier de clé de certificat : .json ou .p12
base de données
string
Nom de la base de données
schema
string
Nom du Scheme
jdbc_additional_params
string
Paramètres supplémentaires à ajouter à la chaîne de connexion JDBC
after_connect_statements
string
Instructions SQL (séparées par un point-virgule) à émettre après la connexion à la base de données. Nécessite la fonctionnalité de licence "custom_after_connect_statements"
géré
booléen
Cette connexion est-elle créée et gérée par Looker ?
port_local_personnalisé
integer
Ce champ ne s'applique qu'aux connexions via un tunnel SSH. La valeur de ce champ correspond au port local associé au tunnel SSH s'il est configuré manuellement. Sinon, saisissez la valeur NULL ou excluez ce champ.
id_tunnel
string
ID du tunnel SSH utilisé par cette connexion
utilise_ntn
booléen
Activer les connexions TNS (Transparent Network Substrate)
simultanéité pdt
integer
Nombre maximal de threads à utiliser pour créer des tables dérivées persistantes en parallèle
désactiver le commentaire de contexte
booléen
Lorsque "disable_context_comment" est défini sur "true", le commentaire n'est pas ajouté à SQL.
ID_application_oauth
string
Application OAuth externe à utiliser pour l'authentification auprès de la base de données
Toujours recompiler_échecs
booléen
Lorsque la valeur est "true", des tables dérivées persistantes d'erreur sont relancées à chaque cycle de régénération
estimation_coût
booléen
Lorsque la valeur est "true", l'estimation du coût de la requête s'affiche dans l'exploration.
pdt_api_control_enabled
booléen
Les générations de tables dérivées persistantes basées sur cette connexion peuvent être lancées et annulées via l'API.

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