Référence du connecteur SurveyMonkey

info

Bêta

Cette fonctionnalité est en bêta. Pour l’utiliser, un administrateur de workspace doit activer Lakeflow Connect pour SurveyMonkey à partir de la page Previews . Consultez Gérer les aperçus Databricks.

Le connecteur SurveyMonkey géré dans Lakeflow Connect prend en charge 11 tables sources dans le schéma default. Les tables surveys, survey_details et survey_responses se synchronisent de manière incrémentielle sur date_modified, et les huit autres tables utilisent une refresh complète.

Tables sources prises en charge

Le connecteur SurveyMonkey prend en charge les tables sources suivantes, toutes sous le schéma source default :

Table source	Clé primaire	Description	Mode de synchronisation	Champ du curseur
`surveys`	`id`	Enquêtes appartenant à l'utilisateur autorisé ou partagées avec cet utilisateur, y compris les nombres, le propriétaire et les URL d'enquête.	Incrémentiel	`date_modified`
`survey_details`	`id`	Structure étendue de l’enquête, incluant les pages et les questions de chaque enquête.	Incrémentiel	`date_modified`
`survey_collectors`	`id`	Collecteurs pour chaque sondage, incluant le type, le statut et le nombre de réponses.	refresh complète seulement
`collectors`	`id`	Paramètres complets du collecteur, y compris les paramètres de remerciement, de disqualification et de limite de réponses.	refresh complète seulement
`survey_responses`	`id`	Les réponses aux enquêtes, y compris les réponses, les métadonnées des répondants et les détails de la collecte.	Incrémentiel	`date_modified`
`survey_folders`	`id`	Enquêtez sur les dossiers du compte, y compris le nombre d’enquêtes dans chaque dossier.	refresh complète seulement
`contacts`	`id`	Contacts dans le compte, y compris le nom, l’adresse e-mail et le numéro de téléphone.	refresh complète seulement
`contact_lists`	`id`	Listes de contacts dans le compte.	refresh complète seulement
`contact_list_contacts`	`contact_list_id`, `id`	Contacts de chaque liste de contacts, y compris les champs personnalisés.	refresh complète seulement
`collector_messages`	`collector_id`, `id`	Messages d'invitation pour chaque collecteur, y compris le type et le statut.	refresh complète seulement
`collector_recipients`	`collector_id`, `id`	Destinataires des invitations de chaque collecteur, y compris le statut du courrier et des réponses.	refresh complète seulement

Table source	Clé primaire	Description	Mode de synchronisation	Champ du curseur
`surveys`	`id`	Enquêtes appartenant à l'utilisateur autorisé ou partagées avec cet utilisateur, y compris les nombres, le propriétaire et les URL d'enquête.	Incrémentiel	`date_modified`
`survey_details`	`id`	Structure étendue de l’enquête, incluant les pages et les questions de chaque enquête.	Incrémentiel	`date_modified`
`survey_collectors`	`id`	Collecteurs pour chaque sondage, incluant le type, le statut et le nombre de réponses.	refresh complète seulement
`collectors`	`id`	Paramètres complets du collecteur, y compris les paramètres de remerciement, de disqualification et de limite de réponses.	refresh complète seulement
`survey_responses`	`id`	Les réponses aux enquêtes, y compris les réponses, les métadonnées des répondants et les détails de la collecte.	Incrémentiel	`date_modified`
`survey_folders`	`id`	Enquêtez sur les dossiers du compte, y compris le nombre d’enquêtes dans chaque dossier.	refresh complète seulement
`contacts`	`id`	Contacts dans le compte, y compris le nom, l’adresse e-mail et le numéro de téléphone.	refresh complète seulement
`contact_lists`	`id`	Listes de contacts dans le compte.	refresh complète seulement
`contact_list_contacts`	`contact_list_id`, `id`	Contacts de chaque liste de contacts, y compris les champs personnalisés.	refresh complète seulement
`collector_messages`	`collector_id`, `id`	Messages d'invitation pour chaque collecteur, y compris le type et le statut.	refresh complète seulement
`collector_recipients`	`collector_id`, `id`	Destinataires des invitations de chaque collecteur, y compris le statut du courrier et des réponses.	refresh complète seulement

Options du connecteur

Voir les exemples d’utilisation.

Option	Type	Portée	Obligatoire	S’applique à	Description
`start_datetime`	Chaîne (`yyyy-MM-ddTHH:mm:ss`, UTC)	Pipeline	Non	Toutes les tables incrémentielles (`surveys`, `survey_details`, `survey_responses`)	Date et heure les plus anciennes à partir desquelles ingérer des données. default : 365 jours avant la première synchronisation. S'applique uniquement à la première synchronisation de chaque table. Les synchronisations ultérieures reprennent à partir du curseur enregistré.

Option	Type	Portée	Obligatoire	S’applique à	Description
`start_datetime`	Chaîne (`yyyy-MM-ddTHH:mm:ss`, UTC)	Pipeline	Non	Toutes les tables incrémentielles (`surveys`, `survey_details`, `survey_responses`)	Date et heure les plus anciennes à partir desquelles ingérer des données. default : 365 jours avant la première synchronisation. S'applique uniquement à la première synchronisation de chaque table. Les synchronisations ultérieures reprennent à partir du curseur enregistré.

Schémas de tables de destination

`surveys`

Clé primaire : id

Mode de synchronisation : Incrémentiel

Champ de curseur : date_modified

Champ	Type de données
`id`	`STRING`
`title`	`STRING`
`nickname`	`STRING`
`language`	`STRING`
`category`	`STRING`
`theme_id`	`STRING`
`template_id`	`BIGINT`
`folder_id`	`STRING`
`question_count`	`BIGINT`
`page_count`	`BIGINT`
`response_count`	`BIGINT`
`date_created`	`TIMESTAMP`
`date_modified`	`TIMESTAMP`
`is_owner`	`BOOLEAN`
`owner`	`STRING`
`footer`	`BOOLEAN`
`buttons_text`	`STRUCT<next_button STRING, prev_button STRING, exit_button STRING, done_button STRING>`
`custom_variables`	`VARIANT`
`href`	`STRING`
`analyze_url`	`STRING`
`edit_url`	`STRING`
`collect_url`	`STRING`
`summary_url`	`STRING`
`preview`	`STRING`

Champ	Type de données
`id`	`STRING`
`title`	`STRING`
`nickname`	`STRING`
`language`	`STRING`
`category`	`STRING`
`theme_id`	`STRING`
`template_id`	`BIGINT`
`folder_id`	`STRING`
`question_count`	`BIGINT`
`page_count`	`BIGINT`
`response_count`	`BIGINT`
`date_created`	`TIMESTAMP`
`date_modified`	`TIMESTAMP`
`is_owner`	`BOOLEAN`
`owner`	`STRING`
`footer`	`BOOLEAN`
`buttons_text`	`STRUCT<next_button STRING, prev_button STRING, exit_button STRING, done_button STRING>`
`custom_variables`	`VARIANT`
`href`	`STRING`
`analyze_url`	`STRING`
`edit_url`	`STRING`
`collect_url`	`STRING`
`summary_url`	`STRING`
`preview`	`STRING`

remarque

Cette table ne prend pas en charge la dimension à évolution lente (SCD) de type 2 car elle comporte des colonnes VARIANT.

`survey_details`

Clé primaire : id

Mode de synchronisation : Incrémentiel

Champ de curseur : date_modified

Champ	Type de données
`id`	`STRING`
`title`	`STRING`
`nickname`	`STRING`
`language`	`STRING`
`folder_id`	`STRING`
`category`	`STRING`
`question_count`	`BIGINT`
`page_count`	`BIGINT`
`response_count`	`BIGINT`
`date_created`	`TIMESTAMP`
`date_modified`	`TIMESTAMP`
`href`	`STRING`
`pages`	ARRAY<STRUCT<`id`: STRING, `title`: STRING, `description`: STRING, `position`: BIGINT, `question_count`: BIGINT, `href`: STRING, `questions`: ARRAY<STRUCT<`id`: STRING, `position`: BIGINT, `visible`: BOOLEAN, `family`: STRING, `subtype`: STRING, `layout`: STRING, `sorting`: STRING, `required`: STRING, `validation`: STRING, `forced_ranking`: BOOLEAN, `headings`: STRING, `answers`: STRING, `href`: STRING>>>>

Champ	Type de données
`id`	`STRING`
`title`	`STRING`
`nickname`	`STRING`
`language`	`STRING`
`folder_id`	`STRING`
`category`	`STRING`
`question_count`	`BIGINT`
`page_count`	`BIGINT`
`response_count`	`BIGINT`
`date_created`	`TIMESTAMP`
`date_modified`	`TIMESTAMP`
`href`	`STRING`
`pages`	ARRAY<STRUCT<`id`: STRING, `title`: STRING, `description`: STRING, `position`: BIGINT, `question_count`: BIGINT, `href`: STRING, `questions`: ARRAY<STRUCT<`id`: STRING, `position`: BIGINT, `visible`: BOOLEAN, `family`: STRING, `subtype`: STRING, `layout`: STRING, `sorting`: STRING, `required`: STRING, `validation`: STRING, `forced_ranking`: BOOLEAN, `headings`: STRING, `answers`: STRING, `href`: STRING>>>>

`survey_collectors`

Clé primaire : id

Mode de synchronisation : refresh complète uniquement

Champ	Type de données
`id`	`STRING`
`survey_id`	`STRING`
`name`	`STRING`
`type`	`STRING`
`status`	`STRING`
`response_count`	`BIGINT`
`date_created`	`TIMESTAMP`
`date_modified`	`TIMESTAMP`
`url`	`STRING`
`href`	`STRING`

`collectors`

Clé primaire : id

Mode de synchronisation : refresh complète uniquement

Champ	Type de données
`id`	`STRING`
`survey_id`	`STRING`
`status`	`STRING`
`type`	`STRING`
`name`	`STRING`
`thank_you_message`	`STRING`
`thank_you_page`	`VARIANT`
`disqualification_type`	`STRING`
`disqualification_message`	`STRING`
`disqualification_url`	`STRING`
`close_date`	`TIMESTAMP`
`closed_page_message`	`STRING`
`redirect_url`	`STRING`
`redirect_type`	`STRING`
`display_survey_results`	`BOOLEAN`
`edit_response_type`	`STRING`
`anonymous_type`	`STRING`
`allow_multiple_responses`	`BOOLEAN`
`password_enabled`	`BOOLEAN`
`respondent_authentication`	`BOOLEAN`
`response_limit`	`BIGINT`
`sender_email`	`STRING`
`response_count`	`BIGINT`
`date_created`	`TIMESTAMP`
`date_modified`	`TIMESTAMP`
`url`	`STRING`
`href`	`STRING`

Champ	Type de données
`id`	`STRING`
`survey_id`	`STRING`
`status`	`STRING`
`type`	`STRING`
`name`	`STRING`
`thank_you_message`	`STRING`
`thank_you_page`	`VARIANT`
`disqualification_type`	`STRING`
`disqualification_message`	`STRING`
`disqualification_url`	`STRING`
`close_date`	`TIMESTAMP`
`closed_page_message`	`STRING`
`redirect_url`	`STRING`
`redirect_type`	`STRING`
`display_survey_results`	`BOOLEAN`
`edit_response_type`	`STRING`
`anonymous_type`	`STRING`
`allow_multiple_responses`	`BOOLEAN`
`password_enabled`	`BOOLEAN`
`respondent_authentication`	`BOOLEAN`
`response_limit`	`BIGINT`
`sender_email`	`STRING`
`response_count`	`BIGINT`
`date_created`	`TIMESTAMP`
`date_modified`	`TIMESTAMP`
`url`	`STRING`
`href`	`STRING`

remarque

Cette table ne prend pas en charge le SCD de type 2 car elle contient des colonnes VARIANT.

`survey_responses`

Clé primaire : id

Mode de synchronisation : Incrémentiel

Champ de curseur : date_modified

Champ	Type de données
`id`	`STRING`
`survey_id`	`STRING`
`collector_id`	`STRING`
`recipient_id`	`STRING`
`collection_mode`	`STRING`
`response_status`	`STRING`
`custom_value`	`STRING`
`first_name`	`STRING`
`last_name`	`STRING`
`email_address`	`STRING`
`ip_address`	`STRING`
`language`	`STRING`
`total_time`	`BIGINT`
`date_created`	`TIMESTAMP`
`date_modified`	`TIMESTAMP`
`logic_path`	`VARIANT`
`metadata`	`VARIANT`
`custom_variables`	`VARIANT`
`page_path`	`VARIANT`
`pages`	`VARIANT`
`edit_url`	`STRING`
`analyze_url`	`STRING`
`href`	`STRING`

Champ	Type de données
`id`	`STRING`
`survey_id`	`STRING`
`collector_id`	`STRING`
`recipient_id`	`STRING`
`collection_mode`	`STRING`
`response_status`	`STRING`
`custom_value`	`STRING`
`first_name`	`STRING`
`last_name`	`STRING`
`email_address`	`STRING`
`ip_address`	`STRING`
`language`	`STRING`
`total_time`	`BIGINT`
`date_created`	`TIMESTAMP`
`date_modified`	`TIMESTAMP`
`logic_path`	`VARIANT`
`metadata`	`VARIANT`
`custom_variables`	`VARIANT`
`page_path`	`VARIANT`
`pages`	`VARIANT`
`edit_url`	`STRING`
`analyze_url`	`STRING`
`href`	`STRING`

remarque

Cette table ne prend pas en charge le SCD de type 2 car elle contient des colonnes VARIANT.

`survey_folders`

Clé primaire : id

Mode de synchronisation : refresh complète uniquement

Champ	Type de données
`id`	`STRING`
`title`	`STRING`
`num_surveys`	`BIGINT`
`href`	`STRING`

remarque

N’incluez pas cette table pour les connexions dont le Région de données est défini sur ca. L'endpoint des dossiers d'enquête SurveyMonkey n'est pas disponible pour les utilisateurs canadiens, donc la mise à jour du pipeline échoue. Voir la documentation de l'API des dossiers d'enquête SurveyMonkey.

`contacts`

Clé primaire : id

Mode de synchronisation : refresh complète uniquement

Champ	Type de données
`id`	`STRING`
`first_name`	`STRING`
`last_name`	`STRING`
`email`	`STRING`
`phone_number`	`STRING`
`href`	`STRING`

`contact_lists`

Clé primaire : id

Mode de synchronisation : refresh complète uniquement

Champ	Type de données
`id`	`STRING`
`name`	`STRING`
`href`	`STRING`

`contact_list_contacts`

Clé principale : contact_list_id, id

Mode de synchronisation : refresh complète uniquement

Champ	Type de données
`id`	`STRING`
`contact_list_id`	`STRING`
`first_name`	`STRING`
`last_name`	`STRING`
`email`	`STRING`
`phone_number`	`STRING`
`custom_fields`	`VARIANT`
`href`	`STRING`

remarque

Cette table ne prend pas en charge le SCD de type 2 car elle contient des colonnes VARIANT.

`collector_messages`

Clé principale : collector_id, id

Mode de synchronisation : refresh complète uniquement

Champ	Type de données
`id`	`STRING`
`collector_id`	`STRING`
`type`	`STRING`
`status`	`STRING`
`href`	`STRING`

`collector_recipients`

Clé principale : collector_id, id

Mode de synchronisation : refresh complète uniquement

Champ	Type de données
`id`	`STRING`
`collector_id`	`STRING`
`email`	`STRING`
`phone_number`	`STRING`
`survey_response_status`	`STRING`
`mail_status`	`STRING`
`custom_fields`	`VARIANT`
`remove_link`	`STRING`
`extra_fields`	`VARIANT`
`survey_link`	`STRING`
`href`	`STRING`

Champ	Type de données
`id`	`STRING`
`collector_id`	`STRING`
`email`	`STRING`
`phone_number`	`STRING`
`survey_response_status`	`STRING`
`mail_status`	`STRING`
`custom_fields`	`VARIANT`
`remove_link`	`STRING`
`extra_fields`	`VARIANT`
`survey_link`	`STRING`
`href`	`STRING`

remarque

Cette table ne prend pas en charge le SCD de type 2 car elle contient des colonnes VARIANT.

Autorisations OAuth requises

L’application SurveyMonkey doit avoir les périmètres suivants. La connexion les demande tous lorsque vous vous connectez. Activez donc chacun d’eux sous Périmètres dans les Paramètres de l’application. Pour plus d’information, consultez la référence des périmètres d’API de SurveyMonkey.

Autorisation	Requis pour
Voir les sondages (`surveys_read`)	`surveys`, `survey_details`, `survey_folders` et chaque table que le connecteur lit par enquête : `survey_collectors`, `collectors`, `survey_responses`, `collector_messages`, `collector_recipients`
Afficher les collecteurs (`collectors_read`)	`survey_collectors`, `collectors`, `collector_messages`, `collector_recipients`
Afficher les contacts (`contacts_read`)	`contacts`, `contact_lists`, `contact_list_contacts`
Afficher les réponses (`responses_read`)	Demandé à la connexion. Aucune table ne le nécessite directement.
Afficher les détails de la réponse (`responses_read_detail`)	`survey_responses`

Autorisation	Requis pour
Voir les sondages (`surveys_read`)	`surveys`, `survey_details`, `survey_folders` et chaque table que le connecteur lit par enquête : `survey_collectors`, `collectors`, `survey_responses`, `collector_messages`, `collector_recipients`
Afficher les collecteurs (`collectors_read`)	`survey_collectors`, `collectors`, `collector_messages`, `collector_recipients`
Afficher les contacts (`contacts_read`)	`contacts`, `contact_lists`, `contact_list_contacts`
Afficher les réponses (`responses_read`)	Demandé à la connexion. Aucune table ne le nécessite directement.
Afficher les détails de la réponse (`responses_read_detail`)	`survey_responses`

Tables sources prises en charge​

Options du connecteur​

Schémas de tables de destination​

surveys​

survey_details​

survey_collectors​

collectors​

survey_responses​

survey_folders​

contacts​

contact_lists​

contact_list_contacts​

collector_messages​

collector_recipients​

Autorisations OAuth requises​

Tables sources prises en charge

Options du connecteur

Schémas de tables de destination

`surveys`

`survey_details`

`survey_collectors`

`collectors`

`survey_responses`

`survey_folders`

`contacts`

`contact_lists`

`contact_list_contacts`

`collector_messages`

`collector_recipients`

Autorisations OAuth requises