Referência do conector do Productboard

info

Beta

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

O conector Productboard gerenciado no Lakeflow Connect é compatível com 18 tabelas de origem no esquema default. Apenas notes é sincronizado incrementalmente usando o cursor updatedAt. As outras 17 tabelas usam refresh completo.

Tabelas de origem compatíveis

O conector Productboard 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
features	id	Recursos e sub-recursos, com todos os valores de campos integrados e personalizados.	Apenas refresh completo
products	id	Produtos na hierarquia de produtos, com valores de campo e a primeira página de relacionamentos.	Apenas refresh completo
components	id	Componentes na hierarquia do produto, com valores de campo.	Apenas refresh completo
feature_statuses	id	Os valores de status que podem ser atribuídos a recursos e sub-recursos.	Apenas refresh completo
notes	id	Notas de feedback do cliente, com valores de campo, estado de arquivo e a primeira página de relacionamentos.	Incremental	updatedAt
companies	id	Empresas, com valores de campo e a primeira página de relacionamentos.	Apenas refresh completo
users	id	Usuários (contatos do cliente), com valores de campo e a primeira página de relacionamentos.	Apenas refresh completo
members	id	Membros do workspace, incluindo membros desabilitados e membros com convites pendentes.	Apenas refresh completo
release_groups	id	Grupos de lançamento, com valores de campo e a primeira página de relacionamentos.	Apenas refresh completo
releases	id	Lançamentos, com valores de campos e a primeira página de relacionamentos.	Apenas refresh completo
objectives	id	Objetivos, com valores de campo e a primeira página de relacionamentos.	Apenas refresh completo
key_results	id	key resultados, com valores de campo e a primeira página de relacionamentos.	Apenas refresh completo
initiatives	id	Iniciativas, com valores de campo e a primeira página de relacionamentos.	Apenas refresh completo
teams	id	Equipes do workspace.	Apenas refresh completo
feature_relationships	feature_id, target_id, relationship_type	O conjunto completo de relacionamentos para cada recurso e sub-recurso, uma linha por relacionamento.	Apenas refresh completo
component_relationships	component_id, target_id, relationship_type	O conjunto completo de relacionamentos para cada componente, uma linha por relacionamento.	Apenas refresh completo
field_definitions	id, entity_type	Configuração de campo para cada tipo de entidade, incluindo campos integrados e personalizados.	Apenas refresh completo
note_field_definitions	id, note_type	Configuração de campo para cada tipo de nota (textNote, conversationNote e opportunityNote).	Apenas refresh completo

Tabela de origem	Chave primária	Descrição	Modo de sincronização	Campo do cursor
features	id	Recursos e sub-recursos, com todos os valores de campos integrados e personalizados.	Apenas refresh completo
products	id	Produtos na hierarquia de produtos, com valores de campo e a primeira página de relacionamentos.	Apenas refresh completo
components	id	Componentes na hierarquia do produto, com valores de campo.	Apenas refresh completo
feature_statuses	id	Os valores de status que podem ser atribuídos a recursos e sub-recursos.	Apenas refresh completo
notes	id	Notas de feedback do cliente, com valores de campo, estado de arquivo e a primeira página de relacionamentos.	Incremental	updatedAt
companies	id	Empresas, com valores de campo e a primeira página de relacionamentos.	Apenas refresh completo
users	id	Usuários (contatos do cliente), com valores de campo e a primeira página de relacionamentos.	Apenas refresh completo
members	id	Membros do workspace, incluindo membros desabilitados e membros com convites pendentes.	Apenas refresh completo
release_groups	id	Grupos de lançamento, com valores de campo e a primeira página de relacionamentos.	Apenas refresh completo
releases	id	Lançamentos, com valores de campos e a primeira página de relacionamentos.	Apenas refresh completo
objectives	id	Objetivos, com valores de campo e a primeira página de relacionamentos.	Apenas refresh completo
key_results	id	key resultados, com valores de campo e a primeira página de relacionamentos.	Apenas refresh completo
initiatives	id	Iniciativas, com valores de campo e a primeira página de relacionamentos.	Apenas refresh completo
teams	id	Equipes do workspace.	Apenas refresh completo
feature_relationships	feature_id, target_id, relationship_type	O conjunto completo de relacionamentos para cada recurso e sub-recurso, uma linha por relacionamento.	Apenas refresh completo
component_relationships	component_id, target_id, relationship_type	O conjunto completo de relacionamentos para cada componente, uma linha por relacionamento.	Apenas refresh completo
field_definitions	id, entity_type	Configuração de campo para cada tipo de entidade, incluindo campos integrados e personalizados.	Apenas refresh completo
note_field_definitions	id, note_type	Configuração de campo para cada tipo de nota (textNote, conversationNote e opportunityNote).	Apenas refresh completo

Opções de conector

O conector do Productboard tem as seguintes opções. Para uso, veja Exemplos.

Opção	Tipo	Escopo	Obrigatório	Aplica-se a	Descrição
start_datetime	String	Pipeline	Não	notes	O valor de updatedAt mais antigo a ser ingerido na primeira sincronização, em formato yyyy-MM-ddTHH:mm:ssZ (por exemplo, 2024-01-01T00:00:00Z). Defaults para 2020-01-01T00:00:00Z.

Opção	Tipo	Escopo	Obrigatório	Aplica-se a	Descrição
start_datetime	String	Pipeline	Não	notes	O valor de updatedAt mais antigo a ser ingerido na primeira sincronização, em formato yyyy-MM-ddTHH:mm:ssZ (por exemplo, 2024-01-01T00:00:00Z). Defaults para 2020-01-01T00:00:00Z.

Esquemas de tabela de destino

features

Chave primária: id Modo de sincronização: Apenas refresh completo

campo	Tipo de dados
id	STRING
type	STRING
createdAt	TIMESTAMP
updatedAt	TIMESTAMP
fields	VARIANT
links	STRUCT<self: STRING, html: STRING>
metadata	STRUCT<source: STRUCT<system: STRING, recordId: STRING, url: STRING>>

campo	Tipo de dados
id	STRING
type	STRING
createdAt	TIMESTAMP
updatedAt	TIMESTAMP
fields	VARIANT
links	STRUCT<self: STRING, html: STRING>
metadata	STRUCT<source: STRUCT<system: STRING, recordId: STRING, url: STRING>>

nota

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

products

Chave primária: id Modo de sincronização: Apenas refresh completo

campo	Tipo de dados
id	STRING
type	STRING
createdAt	TIMESTAMP
updatedAt	TIMESTAMP
fields	VARIANT
links	STRUCT<self: STRING, html: STRING>
relationships	STRUCT<data: ARRAY<STRUCT<type: STRING, target: STRUCT<id: STRING, type: STRING, links: STRUCT<self: STRING, html: STRING>>>>, links: STRUCT<next: STRING>>
metadata	STRUCT<source: STRUCT<system: STRING, recordId: STRING, url: STRING>>

campo	Tipo de dados
id	STRING
type	STRING
createdAt	TIMESTAMP
updatedAt	TIMESTAMP
fields	VARIANT
links	STRUCT<self: STRING, html: STRING>
relationships	STRUCT<data: ARRAY<STRUCT<type: STRING, target: STRUCT<id: STRING, type: STRING, links: STRUCT<self: STRING, html: STRING>>>>, links: STRUCT<next: STRING>>
metadata	STRUCT<source: STRUCT<system: STRING, recordId: STRING, url: STRING>>

nota

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

components

Chave primária: id Modo de sincronização: Apenas refresh completo

campo	Tipo de dados
id	STRING
type	STRING
createdAt	TIMESTAMP
updatedAt	TIMESTAMP
fields	VARIANT
links	STRUCT<self: STRING, html: STRING>
metadata	STRUCT<source: STRUCT<system: STRING, recordId: STRING, url: STRING>>

campo	Tipo de dados
id	STRING
type	STRING
createdAt	TIMESTAMP
updatedAt	TIMESTAMP
fields	VARIANT
links	STRUCT<self: STRING, html: STRING>
metadata	STRUCT<source: STRUCT<system: STRING, recordId: STRING, url: STRING>>

nota

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

feature_statuses

Chave primária: id Modo de sincronização: Apenas refresh completo

campo	Tipo de dados
id	STRING
name	STRING
assignedEntityTypes	ARRAY<STRING>

campo	Tipo de dados
id	STRING
name	STRING
assignedEntityTypes	ARRAY<STRING>

notes

key primária: id Modo de sincronização: Incremental Campo do cursor: updatedAt

campo	Tipo de dados
id	STRING
type	STRING
createdAt	TIMESTAMP
updatedAt	TIMESTAMP
fields	VARIANT
archived	BOOLEAN
links	STRUCT<self: STRING, html: STRING>
relationships	STRUCT<data: ARRAY<STRUCT<type: STRING, target: STRUCT<id: STRING, type: STRING, links: STRUCT<self: STRING>>>>, links: STRUCT<next: STRING>>
metadata	STRUCT<source: STRUCT<system: STRING, recordId: STRING, url: STRING>>

campo	Tipo de dados
id	STRING
type	STRING
createdAt	TIMESTAMP
updatedAt	TIMESTAMP
fields	VARIANT
archived	BOOLEAN
links	STRUCT<self: STRING, html: STRING>
relationships	STRUCT<data: ARRAY<STRUCT<type: STRING, target: STRUCT<id: STRING, type: STRING, links: STRUCT<self: STRING>>>>, links: STRUCT<next: STRING>>
metadata	STRUCT<source: STRUCT<system: STRING, recordId: STRING, url: STRING>>

nota

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

companies

Chave primária: id Modo de sincronização: Apenas refresh completo

campo	Tipo de dados
id	STRING
type	STRING
createdAt	TIMESTAMP
updatedAt	TIMESTAMP
fields	VARIANT
links	STRUCT<self: STRING, html: STRING>
relationships	STRUCT<data: ARRAY<STRUCT<type: STRING, target: STRUCT<id: STRING, type: STRING, links: STRUCT<self: STRING, html: STRING>>>>, links: STRUCT<next: STRING>>
metadata	STRUCT<source: STRUCT<system: STRING, recordId: STRING, url: STRING>>

campo	Tipo de dados
id	STRING
type	STRING
createdAt	TIMESTAMP
updatedAt	TIMESTAMP
fields	VARIANT
links	STRUCT<self: STRING, html: STRING>
relationships	STRUCT<data: ARRAY<STRUCT<type: STRING, target: STRUCT<id: STRING, type: STRING, links: STRUCT<self: STRING, html: STRING>>>>, links: STRUCT<next: STRING>>
metadata	STRUCT<source: STRUCT<system: STRING, recordId: STRING, url: STRING>>

nota

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

users

Chave primária: id Modo de sincronização: Apenas refresh completo

campo	Tipo de dados
id	STRING
type	STRING
createdAt	TIMESTAMP
updatedAt	TIMESTAMP
fields	VARIANT
links	STRUCT<self: STRING, html: STRING>
relationships	STRUCT<data: ARRAY<STRUCT<type: STRING, target: STRUCT<id: STRING, type: STRING, links: STRUCT<self: STRING, html: STRING>>>>, links: STRUCT<next: STRING>>
metadata	STRUCT<source: STRUCT<system: STRING, recordId: STRING, url: STRING>>

campo	Tipo de dados
id	STRING
type	STRING
createdAt	TIMESTAMP
updatedAt	TIMESTAMP
fields	VARIANT
links	STRUCT<self: STRING, html: STRING>
relationships	STRUCT<data: ARRAY<STRUCT<type: STRING, target: STRUCT<id: STRING, type: STRING, links: STRUCT<self: STRING, html: STRING>>>>, links: STRUCT<next: STRING>>
metadata	STRUCT<source: STRUCT<system: STRING, recordId: STRING, url: STRING>>

nota

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

members

Chave primária: id Modo de sincronização: Apenas refresh completo

campo	Tipo de dados
id	STRING
type	STRING
createdAt	TIMESTAMP
updatedAt	TIMESTAMP
fields	STRUCT<name: STRING, username: STRING, email: STRING, role: STRING, disabled: BOOLEAN, invitationPending: BOOLEAN, teams: ARRAY<STRUCT<id: STRING, name: STRING, links: STRUCT<self: STRING>>>>
links	STRUCT<self: STRING, html: STRING>

campo	Tipo de dados
id	STRING
type	STRING
createdAt	TIMESTAMP
updatedAt	TIMESTAMP
fields	STRUCT<name: STRING, username: STRING, email: STRING, role: STRING, disabled: BOOLEAN, invitationPending: BOOLEAN, teams: ARRAY<STRUCT<id: STRING, name: STRING, links: STRUCT<self: STRING>>>>
links	STRUCT<self: STRING, html: STRING>

release_groups

Chave primária: id Modo de sincronização: Apenas refresh completo

campo	Tipo de dados
id	STRING
type	STRING
createdAt	TIMESTAMP
updatedAt	TIMESTAMP
fields	VARIANT
links	STRUCT<self: STRING, html: STRING>
relationships	STRUCT<data: ARRAY<STRUCT<type: STRING, target: STRUCT<id: STRING, type: STRING, links: STRUCT<self: STRING, html: STRING>>>>, links: STRUCT<next: STRING>>
metadata	STRUCT<source: STRUCT<system: STRING, recordId: STRING, url: STRING>>

campo	Tipo de dados
id	STRING
type	STRING
createdAt	TIMESTAMP
updatedAt	TIMESTAMP
fields	VARIANT
links	STRUCT<self: STRING, html: STRING>
relationships	STRUCT<data: ARRAY<STRUCT<type: STRING, target: STRUCT<id: STRING, type: STRING, links: STRUCT<self: STRING, html: STRING>>>>, links: STRUCT<next: STRING>>
metadata	STRUCT<source: STRUCT<system: STRING, recordId: STRING, url: STRING>>

nota

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

releases

Chave primária: id Modo de sincronização: Apenas refresh completo

campo	Tipo de dados
id	STRING
type	STRING
createdAt	TIMESTAMP
updatedAt	TIMESTAMP
fields	VARIANT
links	STRUCT<self: STRING, html: STRING>
relationships	STRUCT<data: ARRAY<STRUCT<type: STRING, target: STRUCT<id: STRING, type: STRING, links: STRUCT<self: STRING, html: STRING>>>>, links: STRUCT<next: STRING>>
metadata	STRUCT<source: STRUCT<system: STRING, recordId: STRING, url: STRING>>

campo	Tipo de dados
id	STRING
type	STRING
createdAt	TIMESTAMP
updatedAt	TIMESTAMP
fields	VARIANT
links	STRUCT<self: STRING, html: STRING>
relationships	STRUCT<data: ARRAY<STRUCT<type: STRING, target: STRUCT<id: STRING, type: STRING, links: STRUCT<self: STRING, html: STRING>>>>, links: STRUCT<next: STRING>>
metadata	STRUCT<source: STRUCT<system: STRING, recordId: STRING, url: STRING>>

nota

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

objectives

Chave primária: id Modo de sincronização: Apenas refresh completo

campo	Tipo de dados
id	STRING
type	STRING
createdAt	TIMESTAMP
updatedAt	TIMESTAMP
fields	VARIANT
links	STRUCT<self: STRING, html: STRING>
relationships	STRUCT<data: ARRAY<STRUCT<type: STRING, target: STRUCT<id: STRING, type: STRING, links: STRUCT<self: STRING, html: STRING>>>>, links: STRUCT<next: STRING>>
metadata	STRUCT<source: STRUCT<system: STRING, recordId: STRING, url: STRING>>

campo	Tipo de dados
id	STRING
type	STRING
createdAt	TIMESTAMP
updatedAt	TIMESTAMP
fields	VARIANT
links	STRUCT<self: STRING, html: STRING>
relationships	STRUCT<data: ARRAY<STRUCT<type: STRING, target: STRUCT<id: STRING, type: STRING, links: STRUCT<self: STRING, html: STRING>>>>, links: STRUCT<next: STRING>>
metadata	STRUCT<source: STRUCT<system: STRING, recordId: STRING, url: STRING>>

nota

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

key_results

Chave primária: id Modo de sincronização: Apenas refresh completo

campo	Tipo de dados
id	STRING
type	STRING
createdAt	TIMESTAMP
updatedAt	TIMESTAMP
fields	VARIANT
links	STRUCT<self: STRING, html: STRING>
relationships	STRUCT<data: ARRAY<STRUCT<type: STRING, target: STRUCT<id: STRING, type: STRING, links: STRUCT<self: STRING, html: STRING>>>>, links: STRUCT<next: STRING>>
metadata	STRUCT<source: STRUCT<system: STRING, recordId: STRING, url: STRING>>

campo	Tipo de dados
id	STRING
type	STRING
createdAt	TIMESTAMP
updatedAt	TIMESTAMP
fields	VARIANT
links	STRUCT<self: STRING, html: STRING>
relationships	STRUCT<data: ARRAY<STRUCT<type: STRING, target: STRUCT<id: STRING, type: STRING, links: STRUCT<self: STRING, html: STRING>>>>, links: STRUCT<next: STRING>>
metadata	STRUCT<source: STRUCT<system: STRING, recordId: STRING, url: STRING>>

nota

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

initiatives

Chave primária: id Modo de sincronização: Apenas refresh completo

campo	Tipo de dados
id	STRING
type	STRING
createdAt	TIMESTAMP
updatedAt	TIMESTAMP
fields	VARIANT
links	STRUCT<self: STRING, html: STRING>
relationships	STRUCT<data: ARRAY<STRUCT<type: STRING, target: STRUCT<id: STRING, type: STRING, links: STRUCT<self: STRING, html: STRING>>>>, links: STRUCT<next: STRING>>
metadata	STRUCT<source: STRUCT<system: STRING, recordId: STRING, url: STRING>>

campo	Tipo de dados
id	STRING
type	STRING
createdAt	TIMESTAMP
updatedAt	TIMESTAMP
fields	VARIANT
links	STRUCT<self: STRING, html: STRING>
relationships	STRUCT<data: ARRAY<STRUCT<type: STRING, target: STRUCT<id: STRING, type: STRING, links: STRUCT<self: STRING, html: STRING>>>>, links: STRUCT<next: STRING>>
metadata	STRUCT<source: STRUCT<system: STRING, recordId: STRING, url: STRING>>

nota

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

teams

Chave primária: id Modo de sincronização: Apenas refresh completo

campo	Tipo de dados
id	STRING
type	STRING
createdAt	TIMESTAMP
updatedAt	TIMESTAMP
fields	STRUCT<name: STRING, handle: STRING, description: STRING>
links	STRUCT<self: STRING, html: STRING, members: STRING>

campo	Tipo de dados
id	STRING
type	STRING
createdAt	TIMESTAMP
updatedAt	TIMESTAMP
fields	STRUCT<name: STRING, handle: STRING, description: STRING>
links	STRUCT<self: STRING, html: STRING, members: STRING>

feature_relationships

Chave primária: feature_id, target_id, relationship_type Modo de sincronização: Apenas atualização refresh

campo	Tipo de dados
feature_id	STRING
target	STRUCT<id: STRING, type: STRING, links: STRUCT<self: STRING, html: STRING>>
target_id	STRING
relationship_type	STRING

campo	Tipo de dados
feature_id	STRING
target	STRUCT<id: STRING, type: STRING, links: STRUCT<self: STRING, html: STRING>>
target_id	STRING
relationship_type	STRING

component_relationships

Chave primária: component_id, target_id, relationship_type Modo de sincronização: Apenas atualização refresh

campo	Tipo de dados
component_id	STRING
target	STRUCT<id: STRING, type: STRING, links: STRUCT<self: STRING, html: STRING>>
target_id	STRING
relationship_type	STRING

campo	Tipo de dados
component_id	STRING
target	STRUCT<id: STRING, type: STRING, links: STRUCT<self: STRING, html: STRING>>
target_id	STRING
relationship_type	STRING

field_definitions

Chave key: id, entity_type Modo de sincronização: Apenas refresh completo

campo	Tipo de dados
id	STRING
name	STRING
path	STRING
entity_type	STRING
schema	VARIANT
values	VARIANT
constraints	VARIANT
lifecycle	VARIANT
default	VARIANT
links	STRUCT<self: STRING>

campo	Tipo de dados
id	STRING
name	STRING
path	STRING
entity_type	STRING
schema	VARIANT
values	VARIANT
constraints	VARIANT
lifecycle	VARIANT
default	VARIANT
links	STRUCT<self: STRING>

nota

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

note_field_definitions

Chave key: id, note_type Modo de sincronização: Apenas refresh completo

campo	Tipo de dados
id	STRING
name	STRING
path	STRING
note_type	STRING
schema	VARIANT
values	VARIANT
constraints	VARIANT
lifecycle	VARIANT
default	VARIANT

campo	Tipo de dados
id	STRING
name	STRING
path	STRING
note_type	STRING
schema	VARIANT
values	VARIANT
constraints	VARIANT
lifecycle	VARIANT
default	VARIANT

nota

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

Permissões OAuth necessárias

O conector solicita os seguintes escopos de leitura quando troca o JWT assinado por um access token. Para obter mais informações, consulte Autenticação na documentação do desenvolvedor do Productboard.

Permissão	Necessário para
entities:read	features, products, components, feature_statuses, companies, users, release_groups, releases, objectives, key_results, initiatives, feature_relationships, component_relationships, field_definitions
notes:read	notes, note_field_definitions
members:read	members
teams:read	teams
members:pii:read	Emails de proprietário e criador não editados nas tabelas de entidade e notes, e nomes de membros, nomes de usuário e emails não editados em members
users:pii:read	Nomes de usuário e emails sem edição em users

Permissão	Necessário para
entities:read	features, products, components, feature_statuses, companies, users, release_groups, releases, objectives, key_results, initiatives, feature_relationships, component_relationships, field_definitions
notes:read	notes, note_field_definitions
members:read	members
teams:read	teams
members:pii:read	Emails de proprietário e criador não editados nas tabelas de entidade e notes, e nomes de membros, nomes de usuário e emails não editados em members
users:pii:read	Nomes de usuário e emails sem edição em users