Pular para o conteúdo principal
Última atualização em

Referência do conector SurveyMonkey

info

Beta

Esse recurso está em Beta. Para usá-lo, um administrador do Workspace deve ativar o Lakeflow Connect para SurveyMonkey na página Pré-visualizações . Consulte Gerenciar prévias do Databricks.

O conector SurveyMonkey gerenciado no Lakeflow Connect oferece suporte a 11 tabelas de origem no esquema default. As tabelas surveys, survey_details e survey_responses sincronizam incrementalmente em date_modified, e as outras oito tabelas usam refresh completo.

Tabelas de origem suportadas​

O conector SurveyMonkey oferece compatibilidade com as seguintes tabelas de origem, todas sob o esquema de origem default:

Tabela de origem

Chave primária

Descrição

Modo de sincronização

Campo do cursor

surveys

id

Pesquisas das quais o usuário autorizador é proprietário ou que estão compartilhadas com esse usuário, incluindo contagens, proprietário e URLs de pesquisa.

Incremental

date_modified

survey_details

id

Estrutura de pesquisa expandida, incluindo as páginas e perguntas de cada pesquisa.

Incremental

date_modified

survey_collectors

id

Coletores para cada pesquisa, incluindo tipo, status e contagem de respostas.

Apenas refresh completo

collectors

id

Configurações completas do coletor, incluindo configurações de agradecimento, desqualificação e limite de resposta.

Apenas refresh completo

survey_responses

id

Respostas da pesquisa, incluindo respostas, metadados dos respondentes e detalhes da coleta.

Incremental

date_modified

survey_folders

id

Pesquise pastas no account, incluindo o número de pesquisas em cada pasta.

Apenas refresh completo

contacts

id

Contatos na account, incluindo nome, endereço de email e número de telefone.

Apenas refresh completo

contact_lists

id

Listas de contatos na account.

Apenas refresh completo

contact_list_contacts

contact_list_id, id

Contatos em cada lista de contatos, incluindo campos personalizados.

Apenas refresh completo

collector_messages

collector_id, id

Mensagens de convite para cada coletor, incluindo tipo e status.

Apenas refresh completo

collector_recipients

collector_id, id

Destinatários dos convites de cada coletor, incluindo status de resposta e e-mail.

Apenas refresh completo

Tabela de origem

Chave primária

Descrição

Modo de sincronização

Campo do cursor

surveys

id

Pesquisas das quais o usuário autorizador é proprietário ou que estão compartilhadas com esse usuário, incluindo contagens, proprietário e URLs de pesquisa.

Incremental

date_modified

survey_details

id

Estrutura de pesquisa expandida, incluindo as páginas e perguntas de cada pesquisa.

Incremental

date_modified

survey_collectors

id

Coletores para cada pesquisa, incluindo tipo, status e contagem de respostas.

Apenas refresh completo

collectors

id

Configurações completas do coletor, incluindo configurações de agradecimento, desqualificação e limite de resposta.

Apenas refresh completo

survey_responses

id

Respostas da pesquisa, incluindo respostas, metadados dos respondentes e detalhes da coleta.

Incremental

date_modified

survey_folders

id

Pesquise pastas no account, incluindo o número de pesquisas em cada pasta.

Apenas refresh completo

contacts

id

Contatos na account, incluindo nome, endereço de email e número de telefone.

Apenas refresh completo

contact_lists

id

Listas de contatos na account.

Apenas refresh completo

contact_list_contacts

contact_list_id, id

Contatos em cada lista de contatos, incluindo campos personalizados.

Apenas refresh completo

collector_messages

collector_id, id

Mensagens de convite para cada coletor, incluindo tipo e status.

Apenas refresh completo

collector_recipients

collector_id, id

Destinatários dos convites de cada coletor, incluindo status de resposta e e-mail.

Apenas refresh completo

Opções do conector​

Consulte Exemplos para ver o uso.

Opção

Tipo

Escopo

Obrigatório

Aplica-se a

Descrição

start_datetime

String (yyyy-MM-ddTHH:mm:ss, UTC)

Pipeline

Não

Todas as tabelas incrementais (surveys, survey_details, survey_responses)

Data e hora mais antigas a partir das quais ingerir dados. O default é 365 dias antes da primeira sincronização. Aplica-se apenas à primeira sincronização de cada tabela. Sincronizações posteriores retomam do cursor armazenado.

Opção

Tipo

Escopo

Obrigatório

Aplica-se a

Descrição

start_datetime

String (yyyy-MM-ddTHH:mm:ss, UTC)

Pipeline

Não

Todas as tabelas incrementais (surveys, survey_details, survey_responses)

Data e hora mais antigas a partir das quais ingerir dados. O default é 365 dias antes da primeira sincronização. Aplica-se apenas à primeira sincronização de cada tabela. Sincronizações posteriores retomam do cursor armazenado.

Esquemas de tabelas de destino​

surveys​

Primary key: id

Modo de sincronização: Incremental

Campo do cursor: date_modified

campo

Tipo de dados

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

campo

Tipo de dados

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

nota

Essa tabela não suporta SCD Tipo 2 (Slowly Changing Dimension) porque tem colunas VARIANT.

survey_details​

Primary key: id

Modo de sincronização: Incremental

Campo do cursor: date_modified

campo

Tipo de dados

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>>>>

campo

Tipo de dados

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​

Primary key: id

Modo de sincronização: Apenas refresh completo

campo

Tipo de dados

id

STRING

survey_id

STRING

name

STRING

type

STRING

status

STRING

response_count

BIGINT

date_created

TIMESTAMP

date_modified

TIMESTAMP

url

STRING

href

STRING

campo

Tipo de dados

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​

Primary key: id

Modo de sincronização: Apenas refresh completo

campo

Tipo de dados

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

campo

Tipo de dados

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

nota

Esta tabela não oferece suporte ao SCD tipo 2 porque possui colunas VARIANT.

survey_responses​

Primary key: id

Modo de sincronização: Incremental

Campo do cursor: date_modified

campo

Tipo de dados

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

campo

Tipo de dados

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

nota

Esta tabela não oferece suporte ao SCD tipo 2 porque possui colunas VARIANT.

survey_folders​

Primary key: id

Modo de sincronização: Apenas refresh completo

campo

Tipo de dados

id

STRING

title

STRING

num_surveys

BIGINT

href

STRING

campo

Tipo de dados

id

STRING

title

STRING

num_surveys

BIGINT

href

STRING

nota

Não inclua esta tabela para conexões com a Região de Dados definida como ca. O endpoint de pastas de pesquisa do SurveyMonkey não está disponível para usuários canadenses, portanto, a atualização do pipeline falha. Consulte a referência da API de pastas de pesquisa do SurveyMonkey.

contacts​

Primary key: id

Modo de sincronização: Apenas refresh completo

campo

Tipo de dados

id

STRING

first_name

STRING

last_name

STRING

email

STRING

phone_number

STRING

href

STRING

campo

Tipo de dados

id

STRING

first_name

STRING

last_name

STRING

email

STRING

phone_number

STRING

href

STRING

contact_lists​

Primary key: id

Modo de sincronização: Apenas refresh completo

campo

Tipo de dados

id

STRING

name

STRING

href

STRING

campo

Tipo de dados

id

STRING

name

STRING

href

STRING

contact_list_contacts​

key primária: contact_list_id, id

Modo de sincronização: Apenas refresh completo

campo

Tipo de dados

id

STRING

contact_list_id

STRING

first_name

STRING

last_name

STRING

email

STRING

phone_number

STRING

custom_fields

VARIANT

href

STRING

campo

Tipo de dados

id

STRING

contact_list_id

STRING

first_name

STRING

last_name

STRING

email

STRING

phone_number

STRING

custom_fields

VARIANT

href

STRING

nota

Esta tabela não oferece suporte ao SCD tipo 2 porque possui colunas VARIANT.

collector_messages​

key primária: collector_id, id

Modo de sincronização: Apenas refresh completo

campo

Tipo de dados

id

STRING

collector_id

STRING

type

STRING

status

STRING

href

STRING

campo

Tipo de dados

id

STRING

collector_id

STRING

type

STRING

status

STRING

href

STRING

collector_recipients​

key primária: collector_id, id

Modo de sincronização: Apenas refresh completo

campo

Tipo de dados

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

campo

Tipo de dados

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

nota

Esta tabela não oferece suporte ao SCD tipo 2 porque possui colunas VARIANT.

Permissões OAuth necessárias​

O aplicativo SurveyMonkey deve ter os seguintes escopos. A conexão solicita todos eles quando você faz login, então ative cada um em Escopos nas Configurações do aplicativo. Para obter mais informações, consulte a referência de escopos da API do SurveyMonkey.

Permissão

Obrigatório para

view pesquisas (surveys_read)

surveys, survey_details, survey_folders, e cada tabela que o conector lê por pesquisa: survey_collectors, collectors, survey_responses, collector_messages, collector_recipients

view Collectors (collectors_read)

survey_collectors, collectors, collector_messages, collector_recipients

view contatos (contacts_read)

contacts, contact_lists, contact_list_contacts

view respostas (responses_read)

Solicitado no login. Nenhuma tabela requer isso diretamente.

view detalhes da resposta (responses_read_detail)

survey_responses

Permissão

Obrigatório para

view pesquisas (surveys_read)

surveys, survey_details, survey_folders, e cada tabela que o conector lê por pesquisa: survey_collectors, collectors, survey_responses, collector_messages, collector_recipients

view Collectors (collectors_read)

survey_collectors, collectors, collector_messages, collector_recipients

view contatos (contacts_read)

contacts, contact_lists, contact_list_contacts

view respostas (responses_read)

Solicitado no login. Nenhuma tabela requer isso diretamente.

view detalhes da resposta (responses_read_detail)

survey_responses

Nesta página