monday.com Detalhes da Conexão¶

Introdução¶

Versão do conector

Esta documentação é baseada na versão 22.0.8510 do conector.

Começando¶

Suporte para a versão de segunda-feira

O conector aproveita a API de segunda-feira para habilitar o acesso bidirecional a segunda-feira.

Estabelecendo uma Conexão¶

Conectando-se à API GraphQL de Segunda-feira¶

Conecte-se usando autenticação de token de API ou autenticação OAuth

Conexão com um Token de API¶

Conecte ao conector especificando o APIToken. Colocou o AuthScheme para Token e obtenha APIToken do seguinte modo:

1. Faça login na sua conta de segunda-feira e navegue até Manage Applications no painel esquerdo.
2. Selecione o aplicativo para o qual deseja criar um token. Pode ser necessário criar um aplicativo primeiro.
3. Clique no Create token botão para gerar um APIToken.

OAuth¶

Como alternativa, você pode estabelecer uma conexão usando autenticação OAuth.

Conectando-se à API do Monday AuditLog¶

Para gerar o token de API de log de auditoria, acesse a seção admin da sua conta Monday, clique na seção "Segurança" e depois na aba"Auditoria". A partir daí, selecione o botão "Monitor by API" e copie-o.

Depois de recuperar o token da API, você pode se conectar a partir do driver definindo as seguintes propriedades de conexão:

• Schema=AuditLog
• AuthScheme=Token
• APIToken=Seu token de API de log de auditoria
• Domain=https://yourdomain.monday.com

Usando Autenticação OAuth¶

OAuth requer que o usuário autenticado interaja com Monday usando o navegador. O conector facilita isso de várias maneiras, conforme descrito abaixo.

Credenciais Personalizadas¶

Você precisa registrar um aplicativo para obter o OAuthClientId e OAuthClientSecret.

Aplicativos de Área de Trabalho

Crie um aplicativo OAuth. Consulte Criando um aplicativo OAuth personalizado para o procedimento.

Criando um Aplicativo OAuth Personalizado¶

Consulte Criando um aplicativo OAuth personalizado para o procedimento.

Credenciais Personalizadas¶

Esta seção descreve a autenticação da área de trabalho usando as credenciais para seu aplicativo OAuth personalizado. Consulte Criando um aplicativo OAuth personalizado Para maiores informações.

Obtenha um Token de Acesso OAuth¶

Depois de definir o seguinte, você está pronto para se conectar:

• AuthScheme: Definido como OAuth.
• OAuthClientId: Defina o ID do cliente nas configurações do aplicativo.
• OAuthClientSecret: Defina o segredo do cliente nas configurações do aplicativo.
• CallbackURL: Defina como URL de redirecionamento nas configurações do aplicativo.
• InitiateOAuth: Definido como GETANDREFRESH. Você pode usar InitiateOAuth para evitar repetir a troca de OAuth e configurar manualmente o OAuthAccessToken.

Quando você se conecta, o conector abre o endpoint OAuth em seu navegador padrão. Faça login e conceda permissões ao aplicativo. O conector conclui o seguinte processo OAuth:

1. Extrai o token de acesso da URL de retorno de chamada e autentica as solicitações.
2. Obtém um novo token de acesso quando o antigo expira.
3. Salva valores OAuth em OAuthSettingsLocation para ser persistido nas conexões.

Máquinas Sem Cabeça¶

Para criar fontes de dados de segunda-feira em servidores headless ou outras máquinas nas quais o conector não pode abrir um navegador, você precisa autenticar de outra máquina. A autenticação é um processo de duas etapas.

1. Ao invés de instalar o conector em outra máquina, você pode seguir os passos abaixo para obter o OAuthVerifier valor. Ou você pode instalar o conector em outra máquina e transferir os valores de autenticação OAuth, depois de autenticar por meio do fluxo normal baseado em navegador.
2. Em seguida, você pode configurar o conector para atualizar automaticamente o token de acesso da máquina sem periféricos.

Você pode seguir o fluxo de autenticação OAuth headless usando as credenciais OAuth incorporadas do conector ou usando as credenciais OAuth para seu aplicativo OAuth personalizado.

Usando as Credenciais para um Aplicativo OAuth Personalizado¶

Crie um Aplicativo OAuth Personalizado¶

Consulte Criando um aplicativo OAuth personalizado para um procedimento. Esta seção descreve o procedimento para autenticar e conectar-se aos dados.

Obtenha um Código Verificador¶

Primeiro, defina as seguintes propriedades na máquina sem periféricos:

• InitiateOAuth: Definido como OFF.
• OAuthClientId: Defina o ID do aplicativo nas configurações do aplicativo.
• OAuthClientSecret: Defina o Segredo do aplicativo nas configurações do aplicativo.

Em seguida, autentique-se em outra máquina e obtenha o OAuthVerifier propriedade da conexão:

1. Chame o GetOAuthAuthorizationURL procedimento armazenado* com o parâmetro de entrada CallbackURL definido para o URI de redirecionamento exato que você especificou nas configurações do aplicativo.
2. Abra o URL retornado em um navegador. Faça login e conceda permissões ao conector. Você será redirecionado para o URL de retorno de chamada, que contém o código do verificador.
3. Salve o valor do código do verificador. Você precisa definir isso no OAuthVerifier propriedade de conexão.

Por fim, na máquina sem periféricos, defina as seguintes propriedades de conexão para obter os valores de autenticação OAuth:

• AuthScheme: Definido como OAuth.
• OAuthClientId: Defina a chave do consumidor nas configurações do aplicativo.
• OAuthClientSecret: Defina como o segredo do consumidor nas configurações do seu aplicativo.
• OAuthVerifier: Defina para o código do verificador.
• OAuthSettingsLocation: Defina para manter os valores de autenticação OAuth criptografados no arquivo especificado.
• InitiateOAuth: Definido como REFRESH.

Conectar aos Dados¶

Depois que o arquivo de configurações OAuth for gerado, defina as seguintes propriedades para se conectar aos dados:

• OAuthSettingsLocation: Defina como o arquivo que contém os valores de autenticação OAuth criptografados. Certifique-se de que este arquivo forneça permissões de leitura e gravação ao provedor para ativar a atualização automática do token de acesso.
• InitiateOAuth: Definido como REFRESH.

Transferir Configurações de OAuth¶

Para instalar o conector em outra máquina, autentique e transfira os valores OAuth resultantes:

1. Em uma segunda máquina, instale o conector e conecte-se com o seguinte conjunto de propriedades:
   • OAuthSettingsLocation: Defina como um arquivo de texto gravável.
   • InitiateOAuth: Definido como GETANDREFRESH.
   • AuthScheme: Definido como OAuth.
   • OAuthClientId: Defina o ID do cliente nas configurações do aplicativo.
   • OAuthClientSecret: Defina o segredo do cliente nas configurações do aplicativo.
   • CallbackURL: Defina o URL de retorno de chamada nas configurações do aplicativo.
2. Teste a conexão para autenticar. Os valores de autenticação resultantes são gravados, criptografados, no caminho especificado por OAuthSettingsLocation. Depois de testar a conexão com sucesso, copie o arquivo de configurações OAuth para sua máquina sem periféricos. Na máquina sem periféricos, defina as seguintes propriedades de conexão para se conectar aos dados:
   • InitiateOAuth: Definido como REFRESH.
   • OAuthSettingsLocation: Defina como o caminho para o arquivo de configurações OAuth. Certifique-se de que este arquivo forneça permissões de leitura e gravação ao conector para habilitar a atualização automática do token de acesso.

Criando um Aplicativo OAuth Personalizado¶

Crie um Aplicativo OAuth Personalizado: Área de Trabalho¶

Conclua o procedimento a seguir para obter o OAuthClientId, OAuthClientSecret, e CallbackURL.

Limitações do GraphQL¶

Cada API GraphQL tem suas próprias limitações e não podemos consultar um número arbitrariamente grande de nós porque cada consultar tem um custo e a API retornará um erro se o conector exceder o custo máximo. A função de custo da consultar depende diretamente dos tamanhos de página. O conector usa seus próprios algoritmos para encontrar os tamanhos de página, mas também oferece a liberdade de ajustá-los com base em suas necessidades. Há duas maneiras de obter esse comportamento:

• Especifique pesos de tamanho de página personalizados incluindo o "other:pageSizeWeights" atributo. Vamos supor que temos uma tabela "Clientes" que possui duas conexões GraphQl aninhadas, empresas e clientes. Se você deseja uma proporção específica entre essas duas entidades por consultar, digamos 200 clientes por 1 empresa, especifique "outro:pageSizeWeights=1:200" no respectivo script. A vantagem desse atributo é que você não ignora nossa lógica para localizar o tamanho de página ideal com base no custo da consultar.
• Especifique tamanhos de página personalizados incluindo o "other:pageSizes" atributo. Ao especificar esse atributo, você ignorará qualquer verificação que fizermos para o custo da consultar, portanto, tome cuidado porque haverá erros de API se você exceder o custo máximo por consultar. Exemplo: "other:pageSizeWeights=10,30", recupere no máximo 10 empresas e no máximo 30 clientes por empresa em uma consultar.

Características Avançadas¶

Esta seção detalha uma seleção de recursos avançados do conector Monday.

Visualizações definidas pelo usuário

O conector permite definir tabelas virtuais, denominadas visões definidas pelo usuário, cujo conteúdo é decidido por uma consultar pré-configurada. Essas exibições são úteis quando você não pode controlar diretamente as consultas enviadas aos drivers. Consulte Visualizações definidas pelo usuário para obter uma visão geral da criação e configuração de exibições personalizadas.

Configuração SSL

Use Configuração SSL para ajustar como o conector lida com as negociações de certificado TLS/SSL. Você pode escolher entre vários formatos de certificado; Veja o SSLServerCert propriedade em "Opções de cadeia de conexão" para obter mais informações.

Procurador

Para configurar o conector usando configurações de proxy do Agente Privado, selecione os Use Proxy Settings caixa de seleção na tela de configuração da conexão.

Processamento de consulta

O conector descarrega o máximo possível do processamento da instrução SELECT para segunda-feira e, em seguida, processa o restante da consultar na memória (do lado do cliente).

Consulte Processamento de consultas Para maiores informações.

Visualizações Definidas pelo Usuário¶

O Jitterbit Connector for Monday permite definir uma tabela virtual cujo conteúdo é decidido por uma consultar pré-configurada. Elas são chamadas de Visualizações Definidas pelo Usuário, que são úteis em situações onde você não pode controlar diretamente a consultar que está sendo emitida para o driver, por exemplo, ao usar o driver do Jitterbit. As Visualizações Definidas pelo Usuário podem ser usadas para definir predicados que são sempre aplicados. Se você especificar predicados adicionais na consultar para a visualização, eles serão combinados com a consultar já definida como parte da visualização.

Há duas maneiras de criar exibições definidas pelo usuário:

• Crie um arquivo de configuração em formato JSON definindo as visualizações desejadas.
• declarações DDL.

Definindo Visualizações Usando um Arquivo de Configuração¶

As visualizações definidas pelo usuário são definidas em um arquivo de configuração formatado em JSON chamado UserDefinedViews.json. O conector detecta automaticamente as visualizações especificadas neste arquivo.

Você também pode ter várias definições de exibição e controlá-las usando o UserDefinedViews propriedade de conexão. Quando você usa essa propriedade, apenas as exibições especificadas são vistas pelo conector.

Este arquivo de configuração de exibição definida pelo usuário é formatado da seguinte forma:

• Cada elemento raiz define o nome de uma exibição.
• Cada elemento raiz contém um elemento filho, chamado query, que contém a consultar SQL personalizada para a visualização.

Por exemplo:

{
    "MyView": {
        "query": "SELECT * FROM Invoices WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

Use o UserDefinedViews propriedade de conexão para especificar a localização do seu arquivo de configuração JSON. Por exemplo:

"UserDefinedViews", "C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json"

Definindo Exibições Usando Instruções DDL¶

O conector também é capaz de criar e alterar o esquema por meio de instruções DDL, como CREATE LOCAL VIEW, ALTER LOCAL VIEW e DROP LOCAL VIEW.

Criar uma Visualização¶

Para criar uma nova visualização usando instruções DDL, forneça o nome da visualização e a consultar da seguinte forma:

CREATE LOCAL VIEW [MyViewName] AS SELECT * FROM Customers LIMIT 20;

Se não existir nenhum arquivo JSON, o código acima criará um. A exibição é então criada no arquivo de configuração JSON e agora pode ser descoberta. O local do arquivo JSON é especificado pelo UserDefinedViews propriedade de conexão.

Alterar uma Visualização¶

Para alterar uma exibição existente, forneça o nome de uma exibição existente ao lado da nova consultar que você gostaria de usar:

ALTER LOCAL VIEW [MyViewName] AS SELECT * FROM Customers WHERE TimeModified > '3/1/2020';

A visualização é então atualizada no arquivo de configuração JSON.

Solte uma Visualização¶

Para descartar uma exibição existente, forneça o nome de um esquema existente ao lado da nova consultar que você gostaria de usar.

DROP LOCAL VIEW [MyViewName]

Isso remove a visualização do arquivo de configuração JSON. Não pode mais ser consultado.

Esquema para Exibições Definidas pelo Usuário¶

As visualizações definidas pelo usuário são expostas no UserViews esquema por padrão. Isso é feito para evitar que o nome da exibição entre em conflito com uma entidade real no modelo de dados. Você pode alterar o nome do esquema usado para UserViews definindo o UserViewsSchemaName propriedade.

Trabalhando com Exibições Definidas pelo Usuário¶

Por exemplo, uma instrução SQL com uma Visualização Definida pelo Usuário chamada UserViews.RCustomers lista apenas clientes em Raleigh:

SELECT * FROM Customers WHERE City = 'Raleigh';

Exemplo de consultar ao driver:

SELECT * FROM UserViews.RCustomers WHERE Status = 'Active';

Resultando na consultar efetiva à fonte:

SELECT * FROM Customers WHERE City = 'Raleigh' AND Status = 'Active';

Esse é um exemplo muito simples de uma consultar a uma exibição definida pelo usuário que é efetivamente uma combinação da consultar de exibição e da definição de exibição. É possível compor essas consultas em padrões muito mais complexos. Todas as operações SQL são permitidas em ambas as consultas e são combinadas quando apropriado.

Configuração SSL¶

Personalizando a Configuração SSL¶

Por padrão, o conector tenta negociar SSL/TLS verificando o certificado do servidor em relação ao armazenamento de certificados confiáveis do sistema.

Para especificar outro certificado, consulte o SSLServerCert propriedade para os formatos disponíveis para fazê-lo.

Modelo de Dados¶

O Jitterbit Connector for Monday modela objetos Monday como tabelas e exibições relacionais. Um objeto Monday tem relacionamentos com outros objetos; nas tabelas, esses relacionamentos são expressos por meio de chaves estrangeiras. As seções a seguir mostram os objetos de API disponíveis e fornecem mais informações sobre como executar SQL para APIs de segunda-feira.

Os esquemas para a maioria dos objetos de banco de dados são definidos em arquivos de configuração simples baseados em texto.

O conector transfere o máximo possível do processamento da instrução SELECT para as APIs de segunda-feira e, em seguida, processa o restante da consultar na memória. Ver SupportEnhancedSQL para obter mais informações sobre como o conector contorna as limitações da API com processamento na memória do lado do cliente.

Usando GraphQL API

Consulte Modelo de dados GraphQL para as entidades disponíveis na API GraphQL.

Usando a API AuditLog

Consulte Modelo de dados do AuditLog para as entidades disponíveis na API AuditLog.

Modelo de Dados GraphQL¶

Visão Geral¶

O Jitterbit Connector for Monday modela objetos Monday como tabelas e exibições relacionais.

Um objeto Monday tem relacionamentos com outros objetos nas tabelas. Esses relacionamentos são expressos por meio de chaves estrangeiras. As seções a seguir mostram os objetos de API disponíveis e fornecem mais informações sobre a execução de SQL para APIs de segunda-feira.

Os esquemas para a maioria dos objetos de banco de dados são definidos em arquivos de configuração simples baseados em texto.

Visualizações¶

Visualizações descreve as exibições disponíveis. As exibições são definidas estaticamente para modelar contas, clientes, produtos e muito mais.

Visualizações¶

As exibições são compostas por colunas e pseudocolunas. As exibições são semelhantes às tabelas na forma como os dados são representados; no entanto, as exibições não oferecem suporte a atualizações. Entidades que são representadas como exibições são normalmente entidades somente leitura. Frequentemente, um procedimento armazenado* está disponível para atualizar os dados se tal funcionalidade for aplicável à fonte de dados.

As consultas podem ser executadas em uma exibição como se fosse uma tabela normal, e os dados retornados são semelhantes nesse aspecto.

Visualizações dinâmicas, como consultas expostas como visualizações e visualizações para procurar combinações específicas de itens de trabalho project_team são suportadas.

Conector Jitterbit para Exibições de Segunda-feira¶

Logs de Atividades¶

A placa registra eventos.

Informações Específicas da Tabela¶

O conector usa a API Monday para processar alguns dos filtros. O conector processa outros filtros do lado do cliente dentro do conector. Você pode desativar a execução da consultar no lado do cliente definindo SupportEnhancedSQL como false, caso em que qualquer critério de pesquisa que se refira a outras colunas causará dados inconsistentes.

Por exemplo, as consultas a seguir são processadas no lado do servidor.

• BoardId suporta os operadores '=, IN'.
• UserId suporta os operadores '=, IN'.
• ColumnId suporta os operadores '=, IN'.
• GroupId suporta os operadores '=, IN'.
• ItemId suporta os operadores '=, IN'.
• CreatedAt suporta os operadores '=, >, >=, <, <='.

SELECIONE

SELECT * FROM ActivityLogs WHERE BoardId IN ('2307103055','2182296646')
SELECT * FROM ActivityLogs WHERE UserId IN ('27278379','28087608')
SELECT * FROM ActivityLogs WHERE ColumnId IN ('27278379','28087608')
SELECT * FROM ActivityLogs WHERE GroupId IN ('27278379','28087608')
SELECT * FROM ActivityLogs WHERE ItemId IN ('27278379','28087608')
SELECT * FROM ActivityLogs WHERE CreatedAt > '2022-02-17 05:12:04.419' AND CreatedAt < '2022-02-17 05:12:04.861'
SELECT * FROM ActivityLogs WHERE CreatedAt >= '2022-02-17 05:12:04.419' AND CreatedAt <= '2022-02-17 05:12:04.861'

Colunas¶

Ativos¶

Obtenha uma coleção de ativos por IDs.

Informações Específicas da Tabela¶

Observação: O filtro de ID é necessário para recuperar dados desta tabela.

O conector usa a API Monday para processar alguns dos filtros. O conector processa outros filtros do lado do cliente dentro do conector. Você pode desativar a execução da consultar no lado do cliente definindo SupportEnhancedSQL como false, caso em que qualquer critério de pesquisa que se refira a outras colunas causará dados inconsistentes. Por exemplo, as consultas a seguir são processadas no lado do servidor.

• Id suporta os operadores '=, IN'.

SELECIONE

SELECT * FROM Assets WHERE Id = '397532775'
SELECT * FROM Assets WHERE ID IN ('397532775','397532776')

Colunas¶

BoardItemsInternal¶

Obtenha uma coleção de IDs de tabuleiros e itens. Esta exibição é apenas para uso interno.

Colunas¶

Pranchas¶

Obtenha uma coleção de placas.

Informações Específicas da Tabela¶

O conector usa a API Monday para processar alguns dos filtros. O conector processa outros filtros do lado do cliente dentro do conector. Você pode desativar a execução da consultar no lado do cliente definindo SupportEnhancedSQL como false, caso em que qualquer critério de pesquisa que se refira a outras colunas causará dados inconsistentes.

Por exemplo, as consultas a seguir são processadas no lado do servidor.

• Id suporta os operadores '=, IN'.
• BoardKind suporta os operadores '='.

SELECIONE

SELECT * FROM Boards WHERE Id = '2182296646'
SELECT * FROM Boards WHERE Id IN ('2307103055','2182296646','2181960030')
SELECT * FROM Boards WHERE Id IN ('2307103055','2182296646','2181960030') AND BoardKind = 'public'
SELECT * FROM Boards WHERE BoardKind = 'public'

Colunas¶

BoardViews¶

As opiniões do conselho.

Informações Específicas da Tabela¶

O conector usa a API Monday para processar alguns dos filtros. O conector processa outros filtros do lado do cliente dentro do conector. Você pode desativar a execução da consultar no lado do cliente definindo SupportEnhancedSQL como false, caso em que qualquer critério de pesquisa que se refira a outras colunas causará dados inconsistentes. Por exemplo, as consultas a seguir são processadas no lado do servidor.

• BoardId suporta os operadores '=, IN'.
• Type suporta o = operador.

SELECIONE

SELECT * FROM BoardViews WHERE BoardId = '2182296646'
SELECT * FROM BoardViews WHERE Type = 'Chart'
SELECT * FROM BoardViews WHERE BoardId IN ('2182296646','2181960030')

Colunas¶

Colunas¶

As colunas visíveis do quadro.

Informações Específicas da Tabela¶

O conector usa a API Monday para processar alguns dos filtros. O conector processa outros filtros do lado do cliente dentro do conector. Você pode desativar a execução da consultar no lado do cliente definindo SupportEnhancedSQL como false, caso em que qualquer critério de pesquisa que se refira a outras colunas causará dados inconsistentes.

Por exemplo, as consultas a seguir são processadas no lado do servidor.

• ID suporta os operadores '=, IN'.
• BoardId suporta os operadores '=, IN'.

SELECIONE

SELECT * FROM Columns WHERE ID = 'name'
SELECT * FROM Columns WHERE ID IN ('name','person')
SELECT * FROM Columns WHERE BoardId = '2182296646'
SELECT * FROM Columns BoardId IN ('2182296646','2181960030')

Colunas¶

Valores da Coluna¶

Os valores da coluna do item.

Informações Específicas da Tabela¶

O conector usa a API Monday para processar alguns dos filtros. O conector processa outros filtros do lado do cliente dentro do conector. Você pode desativar a execução da consultar no lado do cliente definindo SupportEnhancedSQL como false, caso em que qualquer critério de pesquisa que se refira a outras colunas causará dados inconsistentes. Por exemplo, as consultas a seguir são processadas no lado do servidor.

• Id suporta os operadores '=, IN'.
• ItemId suporta os operadores '=, IN'.

SELECIONE

SELECT * FROM ColumnValues WHERE Id = 'person'
SELECT * FROM ColumnValues WHERE Id IN ('person','status')
SELECT * FROM ColumnValues WHERE ItemId IN ('2181853162','2181853151')
SELECT * FROM ColumnValues WHERE ItemId = '2181853162'
SELECT * FROM ColumnValues WHERE ItemId = '2181853162' AND ID = 'status'

Colunas¶

Grupos¶

Os grupos visíveis do quadro.

Informações Específicas da Tabela¶

O conector usa a API Monday para processar alguns dos filtros. O conector processa outros filtros do lado do cliente dentro do conector. Você pode desativar a execução da consultar no lado do cliente definindo SupportEnhancedSQL como false, caso em que qualquer critério de pesquisa que se refira a outras colunas causará dados inconsistentes.

Por exemplo, as consultas a seguir são processadas no lado do servidor.

• Id suporta os operadores '=, IN'.
• BoardId suporta os operadores '=, IN'.

SELECIONE

SELECT * FROM Groups WHERE Id = 'topics'
SELECT * FROM Groups WHERE Id IN ('topics','group_title')
SELECT * FROM Groups WHERE BoardId IN ('2182296646','21822966')
SELECT * FROM Groups WHERE BoardId = '2182296646' AND ID = 'topics'

Colunas¶

Unid¶

Obtenha uma coleção de itens.

Informações Específicas da Tabela¶

O conector usa a API Monday para processar alguns dos filtros. O conector processa outros filtros do lado do cliente dentro do conector. Você pode desativar a execução da consultar no lado do cliente definindo SupportEnhancedSQL como false, caso em que qualquer critério de pesquisa que se refira a outras colunas causará dados inconsistentes.

Por exemplo, as consultas a seguir são processadas no lado do servidor.

• Id suporta os operadores '='.
• BoardId suporta os operadores '='.
• ColumnId suporta os operadores '='.
• ColumnValue suporta os operadores '=, IN'.

SELECIONE

SELECT * FROM Items ORDER BY CreatedAt DESC
SELECT * FROM Items WHERE Id = 2181917692
SELECT * FROM Items WHERE BoardId = '2181917679' AND ColumnId = 'text' AND ColumnValue = 'test'
SELECT * FROM Items WHERE BoardId = '2181917679' AND ColumnId = 'text' AND ColumnValue IN ('Working on it','test')

Colunas¶

Tag¶

Obtenha uma coleção de tags.

Informações Específicas da Tabela¶

O conector usa a API Monday para processar alguns dos filtros. O conector processa outros filtros do lado do cliente dentro do conector. Você pode desativar a execução da consultar no lado do cliente definindo SupportEnhancedSQL como false, caso em que qualquer critério de pesquisa que se refira a outras colunas causará dados inconsistentes. Por exemplo, as consultas a seguir são processadas no lado do servidor.

• ID suporta os operadores '=, IN'.
• IsPrivate suporta o = operador.

SELECIONE

SELECT * FROM Tags WHERE IsPrivate = true
SELECT * FROM Tags WHERE IsPrivate = false
SELECT * FROM Tags WHERE ID = '13327214'
SELECT * FROM Tags WHERE ID IN ('13327214','13327217')

Colunas¶

Equipes¶

Obtenha uma coleção de equipes.

Informações Específicas da Tabela¶

O conector usa a API Monday para processar alguns dos filtros. O conector processa outros filtros do lado do cliente dentro do conector. Você pode desativar a execução da consultar no lado do cliente definindo SupportEnhancedSQL como false, caso em que qualquer critério de pesquisa que se refira a outras colunas causará dados inconsistentes.

Por exemplo, as consultas a seguir são processadas no lado do servidor.

• Id suporta os operadores '=, IN'.

SELECIONE

SELECT * FROM Teams WHERE Id = '565332'
SELECT * FROM Teams WHERE ID IN ('565332,565333')

Colunas¶

Atualizações¶

Obtenha uma coleção de atualizações.

Informações Específicas da Tabela¶

O conector usa a API Monday para processar alguns dos filtros. O conector processa outros filtros do lado do cliente dentro do conector. Você pode desativar a execução da consultar no lado do cliente definindo SupportEnhancedSQL como false, caso em que qualquer critério de pesquisa que se refira a outras colunas causará dados inconsistentes. Por exemplo, as consultas a seguir são processadas no lado do servidor. SELECIONE

SELECT * FROM Updates

Colunas¶

Usuários¶

Obtenha uma coleção de usuários.

Informações Específicas da Tabela¶

O conector usa a API Monday para processar alguns dos filtros. O conector processa outros filtros do lado do cliente dentro do conector. Você pode desativar a execução da consultar no lado do cliente definindo SupportEnhancedSQL como false, caso em que qualquer critério de pesquisa que se refira a outras colunas causará dados inconsistentes. Por exemplo, as consultas a seguir são processadas no lado do servidor.

• ID suporta os operadores '=, IN'.
• IsPending suporta os operadores '='.
• IsGuest suporta os operadores '='.
• Email suporta os operadores '=, IN'.

SELECIONE

SELECT * FROM Users ORDER BY CreatedAt DESC
SELECT * FROM Users WHERE IsPending = true
SELECT * FROM Users WHERE IsGuest = true
SELECT * FROM Users WHERE ID = '27278379'
SELECT * FROM Users WHERE ID IN ('27278379','27278377')
SELECT * FROM Users WHERE Email = 'test@cdata.com'
SELECT * FROM Users WHERE Email IN ('test@cdata.com','test@gmail.com')

Colunas¶

Procedimentos Armazenados¶

Procedimentos armazenados* são interfaces semelhantes a funções que estendem a funcionalidade do conector além das simples operações SELECT com Monday.

Procedimentos armazenados* aceitar uma lista de parâmetros, executar a função pretendida e, em seguida, retornar, se aplicável, quaisquer dados de resposta relevantes da segunda-feira, juntamente com uma indicação de se o procedimento foi bem-sucedido ou falhou.

Conector Jitterbit para Procedimentos Armazenados de Segunda-feira¶

GetOAuthAccessToken¶

Obtém o token de acesso OAuth do GitHub.

Entrada¶

Colunas do Conjunto de Resultados¶

GetOAuthAuthorizationURL¶

Obtém a URL de autorização do GitHub. Acesse a URL retornada na saída em um navegador da Web. Isso solicita o token de acesso que pode ser usado como parte da string de conexão para o GitHub.

Entrada¶

Colunas do Conjunto de Resultados¶

Modelo de Dados AuditLog¶

Visão Geral¶

O Jitterbit Connector for Monday modela objetos Monday como tabelas e exibições relacionais.

Um objeto Monday tem relacionamentos com outros objetos nas tabelas. Esses relacionamentos são expressos por meio de chaves estrangeiras. As seções a seguir mostram os objetos de API disponíveis e fornecem mais informações sobre a execução de SQL para APIs de segunda-feira.

Os esquemas para a maioria dos objetos de banco de dados são definidos em arquivos de configuração simples baseados em texto.

Visualizações¶

Visualizações descreve as exibições disponíveis. As exibições são definidas estaticamente para modelar AuditLogs.

Visualizações¶

As exibições são compostas por colunas e pseudocolunas. As exibições são semelhantes às tabelas na forma como os dados são representados; no entanto, as exibições não oferecem suporte a atualizações. Entidades que são representadas como exibições são normalmente entidades somente leitura. Frequentemente, um procedimento armazenado* está disponível para atualizar os dados se tal funcionalidade for aplicável à fonte de dados.

As consultas podem ser executadas em uma exibição como se fosse uma tabela normal, e os dados retornados são semelhantes nesse aspecto.

Visualizações dinâmicas, como consultas expostas como visualizações e visualizações para procurar combinações específicas de itens de trabalho project_team são suportadas.

Conector Jitterbit para Exibições de Segunda-feira¶

AuditLogs¶

Os eventos de registro de auditoria do conselho.

Informações Específicas da Tabela¶

O conector usa a API Monday para processar alguns dos filtros. O conector processa outros filtros do lado do cliente dentro do conector. Você pode desativar a execução da consultar no lado do cliente definindo SupportEnhancedSQL como false, caso em que qualquer critério de pesquisa que se refira a outras colunas causará dados inconsistentes.

Por exemplo, as consultas a seguir são processadas no lado do servidor.

• Timestamp suporta os operadores '=, >, >=, <, <='.
• UserId suporta o = operador.
• IpAddress suporta o = operador.
• Event suporta os operadores '=, IN'.

Todos os valores disponíveis para o filtro de eventos estão listados e explicados abaixo:

• export-board-activity-log: Exportação do Log de atividades do quadro de logs pelos usuários
• export-account-data: Registra a exportação de dados da conta pelos administradores
• download-attachment: Registra downloads de arquivos pelos usuários
• export-board: Registra as exportações da placa pelos usuários
• export-dashboard: Registra as exportações do painel pelos usuários
• export-content-directory: Registra as exportações do diretório de conteúdo pelos administradores
• login: Registra os logins dos usuários no sistema
• forgot-password: Registra "Esqueceu a senha?" cliques na página de login
• logout: Registra os logouts dos usuários do sistema
• failed-login: Registra as tentativas de login com falha dos usuários
• user-reactivated: Registra a reativação dos usuários pelos administradores
• user-deactivated: Registra a desativação de usuários pelos administradores
• user-details-deleted: Registra a exclusão de usuários pelos administradores
• user-invite: Registra os convites dos usuários de dentro do sistema
• cancel-user-invite: Registra convites de usuários cancelados de dentro do sistema
• user-role-change: Registra a alteração do tipo de usuário pelos administradores
• delete-board: Logs de exclusão de placa pelos usuários
• delete-workspace: Registra a exclusão do espaço de trabalho pelos usuários
• create-team: Registra a criação da equipe pelos usuários
• delete-team: Exclusão de equipe de logs por usuários
• security-settings-change: Registra alterações nas configurações de segurança pelos administradores
• board-broadcast-enabled: Habilitação de transmissão da placa de logs pelos usuários
• add-user-to-team: Registra a adição de usuários a equipes por usuários
• remove-user-from-team: Registra a remoção dos usuários das equipes pelos usuários
• add-user-to-product: Registra a adição de usuários a produtos Work OS
• remove-user-from-product: Registra a remoção dos usuários dos produtos Work OS
• add-team-to-product: Registra a adição das equipes aos produtos Work OS
• remove-team-from-product: Registra a remoção das equipes dos produtos Work OS
• api-complexity-breach-over-time: Registra chamadas de API atingindo o limite da conta

SELECIONE

As seguintes consultas são executadas no lado do servidor:

SELECT * FROM AuditLogs WHERE Timestamp >= '2022-01-01T07:30:00Z' AND Timestamp <= '2022-01-02T07:30:00Z'
SELECT * FROM AuditLogs WHERE Event IN ('export-board-activity-log', 'delete-board')
SELECT * FROM AuditLogs WHERE Timestamp >= '2022-01-01T07:30:00Z' AND Timestamp <= '2022-01-02T07:30:00Z' AND Event = 'delete-board' AND UserId = 27 AND IpAddress = '123.123'

Colunas¶

Tabelas do Sistema¶

Você pode consultar as tabelas do sistema descritas nesta seção para acessar informações de esquema, informações sobre a funcionalidade da fonte de dados e estatísticas de operação em lote.

Tabelas de Esquema¶

As tabelas a seguir retornam metadados do banco de dados para segunda-feira:

• sys_catalogs: Lista os bancos de dados disponíveis.
• sys_schemas: Lista os esquemas disponíveis.
• sys_tables: Lista as tabelas e exibições disponíveis.
• sys_tablecolumns: Descreve as colunas das tabelas e exibições disponíveis.
• sys_procedures: Descreve os procedimentos armazenados disponíveis.
• sys_procedureparameters: Descreve procedimento armazenado* parâmetros.
• sys_keycolumns: Descreve as chaves primárias e estrangeiras.
• sys_indexes: Descreve os índices disponíveis.

Tabelas de Fonte de Dados¶

As tabelas a seguir retornam informações sobre como se conectar e consultar a fonte de dados:

• sys_connection_props: Retorna informações sobre as propriedades de conexão disponíveis.
• sys_sqlinfo: Descreve as consultas SELECT que o conector pode descarregar para a fonte de dados.

Consultar Tabelas de Informações¶

A tabela a seguir retorna estatísticas de consultar para consultas de modificação de dados:

• sys_identity: Retorna informações sobre operações em lote ou atualizações únicas.

Sys_catalogs¶

Lista os bancos de dados disponíveis.

A consultar a seguir recupera todos os bancos de dados determinados pela string de conexão:

SELECT * FROM sys_catalogs

Colunas¶

Sys_schemas¶

Lista os esquemas disponíveis.

A consultar a seguir recupera todos os esquemas disponíveis:

SELECT * FROM sys_schemas

Colunas¶

Sys_tables¶

Lista as tabelas disponíveis.

A consultar a seguir recupera as tabelas e exibições disponíveis:

SELECT * FROM sys_tables

Colunas¶

Sys_tablecolumns¶

Descreve as colunas das tabelas e exibições disponíveis.

A consultar a seguir retorna as colunas e os tipos de dados da tabela Faturas:

SELECT ColumnName, DataTypeName FROM sys_tablecolumns WHERE TableName='Invoices' 

Colunas¶

Sys_procedures¶

Lista os procedimentos armazenados disponíveis.

A consultar a seguir recupera os procedimentos armazenados disponíveis:

SELECT * FROM sys_procedures

Colunas¶

Sys_procedureparameters¶

Descreve procedimento armazenado* parâmetros.

A consultar a seguir retorna informações sobre todos os parâmetros de entrada para o procedimento armazenado SampleProcedure:

SELECT * FROM sys_procedureparameters WHERE ProcedureName='SampleProcedure' AND Direction=1 OR Direction=2

Colunas¶

Sys_keycolumns¶

Descreve as chaves primárias e estrangeiras. A consultar a seguir recupera a chave primária da tabela Faturas:

SELECT * FROM sys_keycolumns WHERE IsKey='True' AND TableName='Invoices'

Colunas¶

Sys_foreignkeys¶

Descreve as chaves estrangeiras. A consultar a seguir recupera todas as chaves estrangeiras que se referem a outras tabelas:

SELECT * FROM sys_foreignkeys WHERE ForeignKeyType = 'FOREIGNKEY_TYPE_IMPORT'

Colunas¶

Sys_primarykeys¶

Descreve as chaves primárias. A consultar a seguir recupera as chaves primárias de todas as tabelas e exibições:

SELECT * FROM sys_primarykeys

Colunas¶

Sys_indexes¶

Descreve os índices disponíveis. Ao filtrar por índices, você pode escrever consultas mais seletivas com tempos de resposta de consultar mais rápidos.

A consultar a seguir recupera todos os índices que não são chaves primárias:

SELECT * FROM sys_indexes WHERE IsPrimary='false'

Colunas¶

Sys_connection_props¶

Retorna informações sobre as propriedades de conexão disponíveis e as definidas na string de conexão.

Ao consultar esta tabela, a string de conexão de configuração deve ser usada:

jdbc:cdata:monday:config:

Esta string de conexão permite que você consultar esta tabela sem uma conexão válida.

A consultar a seguir recupera todas as propriedades de conexão que foram definidas na string de conexão ou definidas por meio de um valor padrão:

SELECT * FROM sys_connection_props WHERE Value <> ''

Colunas¶

Sys_sqlinfo¶

Descreve o processamento da consultar SELECT que o conector pode transferir para a fonte de dados.

Descobrindo os Recursos SELECT da Fonte de Dados¶

Abaixo está um exemplo de conjunto de dados de recursos SQL. O conjunto de resultados a seguir indica a funcionalidade SELECT que o conector pode descarregar para a fonte de dados ou processar o lado do cliente. Sua fonte de dados pode suportar sintaxe SQL adicional. Alguns aspectos da funcionalidade SELECT são retornados em uma lista separada por vírgulas, se suportados; caso contrário, a coluna contém NO.

A consultar a seguir recupera os operadores que podem ser usados na cláusula WHERE:

SELECT * FROM sys_sqlinfo WHERE Name='SUPPORTED_OPERATORS'

Observe que tabelas individuais podem ter diferentes limitações ou requisitos na cláusula WHERE; consulte o Modelo de Dados para obter mais informações.

Colunas¶

Sys_identity¶

Retorna informações sobre tentativas de modificação.

A consultar a seguir recupera os IDs das linhas modificadas em uma operação em lote:

SELECT * FROM sys_identity

Colunas¶

Propriedades de Configurações Avançadas¶

As propriedades de configurações avançadas são as várias opções que podem ser usadas para estabelecer uma conexão. Esta seção fornece uma lista completa das opções que você pode configurar. Clique nos links para mais detalhes.

Autenticação

OAuth

SSL

Esquema

Diversos

Autenticação¶

Esta seção fornece uma lista completa de propriedades de autenticação que você pode configurar.

Esquema¶

Especifica qual API de segunda-feira usar.

Valores Possíveis¶

GraphQL, AuditLog

Tipo de Dados¶

string

Valor Padrão¶

"GraphQL"

Observações¶

Os valores disponíveis são GraphQL e AuditLog.

AuthScheme¶

O tipo de autenticação a ser usado ao conectar-se a Monday.

Valores Possíveis¶

Token, OAuth

Tipo de Dados¶

string

Valor Padrão¶

"Token"

Observações¶

• Token: Defina para executar a autenticação de token de segunda-feira.
• OAuth: Defina para executar a autenticação OAuth de segunda-feira.

APIToken¶

O token de API obtido de sua conta de segunda-feira.

Tipo de Dados¶

string

Valor Padrão¶

""

Observações¶

Aba Admin

Se você for um usuário administrador em sua conta monday.com, poderá acessar seus tokens de API na aba "Admin" com as seguintes etapas:

1. Faça login na sua conta monday.com.
2. Clique no seu avatar (ícone de imagem) no canto inferior esquerdo da tela.
3. Selecione Admin no menu resultante (isso requer que você tenha permissões de administrador).
4. Vá para a seção API.
5. Gere um "token API v2"
6. Copie seu token.

Aba Desenvolvedor

Se você for um usuário membro em sua conta monday.com, poderá acessar seus tokens de API na aba Desenvolvedor com as seguintes etapas:

1. Faça login na sua conta monday.com.
2. Clique no seu avatar (ícone de imagem) no canto inferior esquerdo da tela.
3. Selecione Desenvolvedor no menu resultante.
4. No menu superior, clique no menu suspenso "Desenvolvedor".
5. Selecione a primeira opção no menu suspenso intitulada "Meus tokens de acesso".
6. Clique no botão azul "Mostrar" para expor seu token de API e copiá-lo.

Domínio¶

Especifique o domínio da sua conta do Monday. Obrigatório apenas ao usar o esquema AuditLog. Exemplo: https://yourdomain.monday.com.

Tipo de Dados¶

string

Valor Padrão¶

""

Observações¶

Especifique o domínio da sua conta do Monday. Obrigatório apenas ao usar o esquema AuditLog. Exemplo: https://yourdomain.monday.com

OAuth¶

Esta seção fornece uma lista completa de propriedades OAuth que você pode configurar.

InitiateOAuth¶

Configure esta propriedade para iniciar o processo para obter ou atualizar o token de acesso OAuth ao se conectar.

Valores Possíveis¶

OFF, GETANDREFRESH, REFRESH

Tipo de Dados¶

string

Valor Padrão¶

"OFF"

Observações¶

As seguintes opções estão disponíveis:

1. OFF: Indica que o fluxo OAuth será tratado inteiramente pelo usuário. Um OAuthAccessToken será necessário para autenticação.
2. GETANDREFRESH: Indica que todo o fluxo OAuth será tratado pelo conector. Se nenhum token existir atualmente, ele será obtido solicitando ao usuário por meio do navegador. Se existir um token, ele será atualizado quando aplicável.
3. REFRESH: Indica que o conector tratará apenas da atualização do OAuthAccessToken. O usuário nunca será solicitado pelo conector a autenticar por meio do navegador. O usuário deve manipular a obtenção do OAuthAccessToken e OAuthRefreshToken inicialmente.

OAuthClientId¶

O ID do cliente atribuído quando você registra seu aplicativo com um servidor de autorização OAuth.

Tipo de Dados¶

string

Valor Padrão¶

""

Observações¶

Como parte do registro de um aplicativo OAuth, você receberá o OAuthClientId valor, às vezes também chamado de chave do consumidor e segredo do cliente, o OAuthClientSecret.

OAuthClientSecret¶

O segredo do cliente atribuído quando você registra seu aplicativo com um servidor de autorização OAuth.

Tipo de Dados¶

string

Valor Padrão¶

""

Observações¶

Como parte do registro de um aplicativo OAuth, você receberá o OAuthClientId, também chamada de chave do consumidor. Você também receberá um segredo do cliente, também chamado de segredo do consumidor. Defina o segredo do cliente no OAuthClientSecret propriedade.

OAuthAccessToken¶

O token de acesso para conexão usando OAuth.

Tipo de Dados¶

string

Valor Padrão¶

""

Observações¶

O OAuthAccessToken propriedade é usada para conectar usando OAuth. O OAuthAccessToken é recuperado do servidor OAuth como parte do processo de autenticação. Ele tem um tempo limite dependente do servidor e pode ser reutilizado entre as solicitações.

O token de acesso é usado no lugar do seu nome de usuário e senha. O token de acesso protege suas credenciais, mantendo-as no servidor.

URL de Retorno¶

O URL de retorno de chamada OAuth para o qual retornar durante a autenticação. Esse valor deve corresponder ao URL de retorno de chamada especificado nas configurações do aplicativo.

Tipo de Dados¶

string

Valor Padrão¶

""

Observações¶

Durante o processo de autenticação, o servidor de autorização OAuth redireciona o usuário para esta URL. Esse valor deve corresponder ao URL de retorno especificado nas configurações do aplicativo.

OAuthVerifier¶

O código do verificador retornado da URL de autorização OAuth.

Tipo de Dados¶

string

Valor Padrão¶

""

Observações¶

O código do verificador retornado da URL de autorização OAuth. Isso pode ser usado em sistemas onde um navegador não pode ser iniciado, como sistemas headless.

Autenticação em Máquinas Sem Cabeça¶

Consulte para obter o OAuthVerifier valor.

Defina OAuthSettingsLocation juntamente com OAuthVerifier. Quando você conecta, o conector troca o OAuthVerifier para os tokens de autenticação OAuth e os salva, criptografados, no arquivo especificado. Definir InitiateOAuth para GETANDREFRESH para automatizar a troca.

Depois que o arquivo de configurações OAuth for gerado, você poderá remover OAuthVerifier nas propriedades de conexão e conecte-se com OAuthSettingsLocation definir.

Para atualizar automaticamente os valores do token OAuth, defina OAuthSettingsLocation e adicionalmente defina InitiateOAuth para ATUALIZAR.

OAuthRefreshToken¶

O token de atualização OAuth para o token de acesso OAuth correspondente.

Tipo de Dados¶

string

Valor Padrão¶

""

Observações¶

O OAuthRefreshToken a propriedade é usada para atualizar o OAuthAccessToken ao usar a autenticação OAuth.

OAuthExpiresIn¶

O tempo de vida em segundos do OAuth AccessToken.

Tipo de Dados¶

string

Valor Padrão¶

""

Observações¶

Emparelhe com OAuthTokenTimestamp para determinar quando o AccessToken expirará.

OAuthTokenTimestamp¶

O registro de data e hora da época do Unix em milissegundos quando o token de acesso atual foi criado.

Tipo de Dados¶

string

Valor Padrão¶

""

Observações¶

Emparelhe com OAuthExpiresIn para determinar quando o AccessToken expirará.

SSL¶

Esta seção fornece uma lista completa de propriedades SSL que você pode configurar.

SSLServerCert¶

O certificado a ser aceito do servidor ao conectar usando TLS/SSL.

Tipo de Dados¶

string

Valor Padrão¶

""

Observações¶

Se estiver usando uma conexão TLS/SSL, esta propriedade pode ser usada para especificar o certificado TLS/SSL a ser aceito do servidor. Qualquer outro certificado que não seja confiável para a máquina é rejeitado.

Esta propriedade pode assumir as seguintes formas:

Se não for especificado, qualquer certificado confiável pela máquina será aceito.

Os certificados são validados como confiáveis pela máquina com base no armazenamento confiável do sistema. O armazenamento confiável usado é o valor 'javax.net.ssl.trustStore' especificado para o sistema. Se nenhum valor for especificado para esta propriedade, o armazenamento confiável padrão do Java será usado (por exemplo, JAVA_HOME\lib\security\cacerts).

Use '*' para indicar a aceitação de todos os certificados. Observe que isso não é recomendado devido a questões de segurança.

Esquema¶

Esta seção fornece uma lista completa de propriedades de esquema que você pode configurar.

Localização¶

Um caminho para o diretório que contém os arquivos de esquema que definem tabelas, exibições e procedimentos armazenados.

Tipo de Dados¶

string

Valor Padrão¶

"%APPDATA%\\\Monday Data Provider\\Schema"

Observações¶

O caminho para um diretório que contém os arquivos de esquema para o conector (arquivos .rsd para tabelas e exibições, arquivos .rsb para procedimentos armazenados). A localização da pasta pode ser um caminho relativo a partir da localização do executável. O Location a propriedade só é necessária se você quiser personalizar definições (por exemplo, alterar um nome de coluna, ignorar uma coluna e assim por diante) ou estender o modelo de dados com novas tabelas, exibições ou procedimentos armazenados.

Se não for especificado, o local padrão é "%APPDATA%\\Monday Data Provider\Schema" com %APPDATA% sendo definido para o diretório de configuração do usuário:

Esquemas Navegáveis¶

Essa propriedade restringe os esquemas relatados a um subconjunto dos esquemas disponíveis. Por exemplo, BrowsableSchemas=SchemaA,SchemaB,SchemaC.

Tipo de Dados¶

string

Valor Padrão¶

""

Observações¶

Listar os esquemas de bancos de dados pode ser caro. Fornecer uma lista de esquemas na string de conexão melhora o desempenho.

Tabelas¶

Esta propriedade restringe as tabelas reportadas a um subconjunto das tabelas disponíveis. Por exemplo, Tabelas=TabelaA,TabelaB,TabelaC.

Tipo de Dados¶

string

Valor Padrão¶

""

Observações¶

Listar as tabelas de alguns bancos de dados pode ser caro. Fornecer uma lista de tabelas na string de conexão melhora o desempenho do conector.

Essa propriedade também pode ser usada como uma alternativa para listar automaticamente as exibições se você já souber com quais deseja trabalhar e, caso contrário, haveria muitos para trabalhar.

Especifique as tabelas que deseja em uma lista separada por vírgulas. Cada tabela deve ser um identificador SQL válido com quaisquer caracteres especiais escapados usando colchetes, aspas duplas ou acentos graves. Por exemplo, Tables=TableA,[TableB/WithSlash],WithCatalog.WithSchema.`TableC With Space`.

Observe que, ao conectar-se a uma fonte de dados com vários esquemas ou catálogos, você precisará fornecer o nome totalmente qualificado da tabela nesta propriedade, como no último exemplo aqui, para evitar ambigüidade entre tabelas que existem em vários catálogos ou esquemas.

Visualizações¶

Restringe as visualizações relatadas a um subconjunto das tabelas disponíveis. Por exemplo, Views=ViewA,ViewB,ViewC.

Tipo de Dados¶

string

Valor Padrão¶

""

Observações¶

Listar as exibições de alguns bancos de dados pode ser caro. Fornecer uma lista de exibições na string de conexão melhora o desempenho do conector.

Essa propriedade também pode ser usada como uma alternativa para listar automaticamente as exibições se você já souber com quais deseja trabalhar e, caso contrário, haveria muitas para trabalhar.

Especifique as exibições desejadas em uma lista separada por vírgulas. Cada exibição deve ser um identificador SQL válido com quaisquer caracteres especiais escapados usando colchetes, aspas duplas ou acentos graves. Por exemplo, Views=ViewA,[ViewB/WithSlash],WithCatalog.WithSchema.`ViewC With Space`.

Observe que, ao conectar-se a uma fonte de dados com vários esquemas ou catálogos, você precisará fornecer o nome totalmente qualificado da tabela nesta propriedade, como no último exemplo aqui, para evitar ambigüidade entre tabelas que existem em vários catálogos ou esquemas.

Diversos¶

Esta seção fornece uma lista completa de diversas propriedades que você pode configurar.

MaxPointsPerCall¶

Especifica quantos pontos uma ligação custará.

Tipo de Dados¶

string

Valor Padrão¶

"1000000"

Observações¶

O custo total de suas consultas não pode exceder 5.000.000 de pontos a qualquer momento.

MaxRows¶

Limita o número de linhas retornadas quando nenhuma agregação ou agrupamento é usado na consultar. Isso ajuda a evitar problemas de desempenho em tempo de design.

Tipo de Dados¶

int

Valor Padrão¶

-1

Observações¶

Limita o número de linhas retornadas quando nenhuma agregação ou agrupamento é usado na consultar. Isso ajuda a evitar problemas de desempenho em tempo de design.

Outro¶

Essas propriedades ocultas são usadas apenas em casos de uso específicos.

Tipo de Dados¶

string

Valor Padrão¶

""

Observações¶

As propriedades listadas abaixo estão disponíveis para casos de uso específicos. Os casos de uso e a funcionalidade normais do driver não devem exigir essas propriedades.

Especifique várias propriedades em uma lista separada por ponto e vírgula.

Integração e Formatação¶

Pseudocolunas¶

Esta propriedade indica se deve ou não incluir pseudocolunas como colunas na tabela.

Tipo de Dados¶

string

Valor Padrão¶

""

Observações¶

Essa configuração é particularmente útil no Entity Framework, que não permite definir um valor para uma pseudocoluna, a menos que seja uma coluna de tabela. O valor dessa configuração de conexão está no formato "Table1=Column1, Table1=Column2, Table2=Column3". Você pode usar o caractere "*" para incluir todas as tabelas e todas as colunas; por exemplo, "*=*".

Tempo Esgotado¶

O valor em segundos até que o erro de timeout seja lançado, cancelando a operação.

Tipo de Dados¶

int

Valor Padrão¶

60

Observações¶

Se Timeout = 0, as operações não expiram. As operações são executadas até serem concluídas com êxito ou até encontrarem uma condição de erro.

Se Timeout expira e a operação ainda não está concluída, o conector lança uma exceção.

UserDefinedViews¶

Um caminho de arquivo apontando para o arquivo de configuração JSON que contém suas exibições personalizadas.

Tipo de Dados¶

string

Valor Padrão¶

""

Observações¶

As visualizações definidas pelo usuário são definidas em um arquivo de configuração formatado em JSON chamado UserDefinedViews.json. O conector detecta automaticamente as visualizações especificadas neste arquivo.

Você também pode ter várias definições de exibição e controlá-las usando o UserDefinedViews propriedade de conexão. Quando você usa essa propriedade, apenas as exibições especificadas são vistas pelo conector.

Este arquivo de configuração de exibição definida pelo usuário é formatado da seguinte forma:

• Cada elemento raiz define o nome de uma exibição.
• Cada elemento raiz contém um elemento filho, chamado query, que contém a consultar SQL personalizada para a visualização.

Por exemplo:

{
    "MyView": {
        "query": "SELECT * FROM Invoices WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

Use o UserDefinedViews propriedade de conexão para especificar a localização do seu arquivo de configuração JSON. Por exemplo:

"UserDefinedViews", "C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json"