Detalhes da Conexão de Microsoft Azure Table Storage

Introdução

Versão do conector

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

Começando

Suporte à versão de armazenamento de tabelas do Azure

Estabelecendo uma Conexão

Conectando-se às APIs de Armazenamento de Tabelas do Azure

O driver se conectará à conta Azure Table Storage especificada por Account. Por padrão, as conexões com o Armazenamento de Tabelas do Azure são protegidas via SSL, embora isso possa ser controlado por meio de UseSSL. O método de autenticação para o Armazenamento de Tabelas do Azure é determinado pelo AuthScheme propriedade.

Autenticação no Armazenamento de Tabelas do Azure

Os seguintes mecanismos podem ser usados para autenticar.

Autenticação com Chave de Acesso

Definir Account ao nome da conta de armazenamento e defina o AccessKey da conta de armazenamento para se conectar. Siga os passos abaixo para obter esses valores:

Se estiver usando Armazenamento como o Backend (padrão):

1. Faça logon no portal do Azure e selecione Contas de armazenamento no menu de serviços à esquerda.
2. Se você não tiver nenhuma conta de armazenamento, crie uma clicando no botão Adicionar.
3. Clique no link da conta de armazenamento que deseja usar e selecione Chaves de acesso em Configurações. A janela Chaves de acesso contém o nome e a chave da conta de armazenamento (você pode usar key1 ou key2 para conectar) que precisará usar no conector. Essas propriedades são mapeadas para Account e AccessKey propriedades de conexão do conector, respectivamente.

Se estiver usando o CosmosDB como o Backend:

1. Faça logon no portal do Azure e selecione Cosmos DB no menu de serviços à esquerda.
2. Clique no link da conta do Cosmos DB que deseja usar e selecione Cadeia de conexão em Configurações. A janela Connection String contém o nome da conta do Cosmos DB e a chave primária que você precisará usar no conector. Essas propriedades são mapeadas para Account e AccessKey propriedades de conexão do conector, respectivamente.

Autenticação com Assinatura de Acesso Compartilhado

Definir Account ao nome da conta de armazenamento e defina o SharedAccessSignature para uma assinatura válida de um recurso ao qual se conectar. O SharedAccessSignature pode ser gerado com uma ferramenta como o Azure Storage Explorer.

Normalmente quando SharedAccessSignature é usado, a tabela específica para trabalhar também deve ser especificada através do Tables propriedade de conexão. Se nenhuma tabela for especificada, uma listagem de tabela será tentada, mas pode falhar devido à falta de permissões.

Anotações Importantes

Procedimentos Armazenados

• Os recursos de procedimentos armazenados descritos nesta documentação não são suportados no momento.
• Como os procedimentos armazenados não são suportados atualmente, qualquer recurso dependente de procedimentos armazenados também não é suportado atualmente.

Arquivos de Configuração e Seus Caminhos

• Todas as referências para adicionar arquivos de configuração e seus caminhos referem-se a arquivos e locais no Harmony Agente onde o conector está instalado. Esses caminhos devem ser ajustados conforme apropriado, dependendo do agente e do sistema operacional. Se vários agentes forem usados em um grupo de agentes, arquivos idênticos serão necessários em cada agente.

Características Avançadas

Esta seção detalha uma seleção de recursos avançados do conector Azure Table Storage.

Visualizações definidas pelo usuário

O conector permite definir tabelas virtuais, denominadas visualizaçõ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.

Visualizações Definidas pelo Usuário

O Jitterbit Connector for Azure Table Storage 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 exibição.

Por exemplo:

{
    "MyView": {
        "query": "SELECT * FROM NorthwindProducts 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"

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 conector permite que você acesse dados no armazenamento de tabelas do Azure por meio de uma interface semelhante a um banco de dados padrão. As tabelas do Azure são bancos de dados de nuvem NoSQL altamente escalonáveis que são muito diferentes de um banco de dados regular. Nesta seção, descrevemos como modelamos tabelas sem esquema do Azure como tabelas regulares. Veja Tabelas, Colunas da tabela e Procedimentos armazenados.

Tabelas

A lista de tabelas é recuperada dinamicamente de sua conta do Azure, para que quaisquer adições ou exclusões sejam refletidas imediatamente quando você se conectar ao conector. Você pode usar o CreateTable procedimento armazenado* para criar uma nova tabela.

As tabelas do Azure exigem uma chave de partição e uma chave de linha. Ambos precisarão ser definidos para todas as consultas, exceto as consultas SELECT.

Colunas da Tabela

Como as tabelas do Azure Table Storage não têm esquema, o conector oferece os dois mecanismos a seguir para descobrir o esquema.

Esquemas Dinâmicos

As colunas de uma tabela são determinadas dinamicamente pela varredura de dados nas primeiras linhas. Você pode ajustar o número de linhas usadas modificando o RowScanDepth propriedade. Quando TypeDetectionScheme é definido como "RowScan", a varredura de linha também determina o tipo de dados. A tabela a seguir mostra como os diferentes tipos de dados com suporte no Azure Table Storage são modelados no conector.

Esquemas Estáticos

Em vez de usar esquemas descobertos dinamicamente, você pode definir seus próprios esquemas. Isso lhe dará mais controle sobre as colunas projetadas e também permitirá que você defina manualmente os tipos de dados. Consulte o esquema de amostra incluído no conector para definir seu próprio esquema. Você pode simplesmente alterar o nome do arquivo de esquema de exemplo, que deve corresponder ao nome da tabela do Azure Table Storage, e editar a lista de colunas para usá-la em sua própria tabela.

Operações Sem Esquema

O esquema da tabela é necessário para recuperar os dados, quer você os defina manualmente ou os obtenha dinamicamente. No entanto, os dados podem ser inseridos, atualizados ou excluídos de colunas que não existem no esquema. As colunas que ainda não existem no esquema da tabela terão seus tipos de dados definidos como String.

Procedimentos Armazenados

Procedimentos armazenados* estão disponíveis para complementar os dados disponíveis no Modelo de Dados. Pode ser necessário atualizar os dados disponíveis em uma exibição usando um procedimento armazenado* porque os dados não fornecem atualizações bidirecionais diretas, semelhantes a tabelas. Nessas situações, a recuperação dos dados é feita usando a visualização ou tabela apropriada, enquanto a atualização é feita chamando um procedimento armazenado. Procedimentos armazenados* pega uma lista de parâmetros e retorna um conjunto de dados que contém a coleção de tuplas que constituem a resposta.

Conector Jitterbit para Procedimentos Armazenados de Armazenamento de Tabelas do Azure

CreateEntityWithTypes

Cria um novo registro com os tipos de dados fornecidos. Se uma coluna não for encontrada em uma entidade existente, você precisará usar este procedimento para definir o tipo da propriedade para algo diferente de string.

Note: Este procedimento faz uso de indexed parameters. Esses parâmetros de entrada são indicados com um # no final de seus nomes.

Os parâmetros indexados facilitam o fornecimento de várias instâncias de um único parâmetro como entradas para o procedimento.

Suponha que haja um parâmetro de entrada chamado Param#. Insira várias instâncias de um parâmetro indexado como este:

EXEC ProcedureName Param#1 = "value1", Param#2 = "value2", Param#3 = "value3"

Entrada

Colunas do Conjunto de Resultados

Criar Esquema

Cria um arquivo de esquema para a tabela ou exibição especificada.

Entrada

Colunas do Conjunto de Resultados

Criar a Tabela

Cria uma nova tabela no sistema Azure.

Entrada

Colunas do Conjunto de Resultados

DropTable

Descarta uma tabela existente no sistema Azure.

Entrada

Colunas do Conjunto de Resultados

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 de banco de dados para armazenamento de tabelas do Azure:

• 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 NorthwindProducts:

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

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

SELECT * FROM sys_procedureparameters WHERE ProcedureName='CreateTable' 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 NorthwindProducts:

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

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_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:azuretables: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.

Processamento de Consultas Colaborativas

Ao trabalhar com fontes de dados que não suportam SQL-92, você pode consultar a exibição sys_sqlinfo para determinar os recursos de consultar das APIs subjacentes, expressas na sintaxe SQL. O conector transfere o máximo possível do processamento da instrução SELECT para o servidor e, em seguida, processa o restante da consultar na memória.

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

Mapeamento de Tipo de Dados

Mapeamentos de Tipo de Dados

O conector mapeia os tipos da fonte de dados para o tipo de dados correspondente disponível no esquema. A tabela abaixo documenta esses mapeamentos.

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

SSL

Esquema

Diversos

Autenticação

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

Conta

O nome da conta de armazenamento do Windows Azure.

Tipo de Dados

string

Valor Padrão

""

Observações

O nome da conta de armazenamento do Windows Azure. Para acessar suas contas de armazenamento do Azure ou criar uma, faça login no portal do Azure Clique em Contas de armazenamento no menu de serviços à esquerda.

Se Back-end estiver definido como AzureStack, defina a Conta como o hospedar completo para seus dados. Por exemplo: <account>.nm.azs.sandia.gov.

Se Back-end estiver definido como Emulador, defina a Conta como o hospedar completo. Por exemplo: http://127.0.0.1:10002/devstoreaccount1.

Usar SSL

Este campo define se o SSL está ativado. O padrão é verdadeiro.

Tipo de Dados

bool

Valor Padrão

true

Observações

Este campo define se o SSL está ativado. O padrão é verdadeiro.

Chave de Acesso

A chave para a conta de armazenamento.

Tipo de Dados

string

Valor Padrão

""

Observações

Para obter a chave de acesso, faça logon no portal do Azure e clique em Contas de armazenamento no menu de serviços à esquerda para listar as contas de armazenamento. Selecione uma conta de armazenamento e clique em Chaves de acesso na seção Configurações. Tanto key1 quanto key2 podem ser usados.

Se estiver usando o CosmosDB como Back-end, em vez disso, navegue até o serviço Cosmos DB e selecione sua conta do Azure Cosmos DB. No menu de recursos, vá para a página String de conexão. Encontre o valor PRIMARY KEY e defina AccessKey para este valor.

AuthScheme

O esquema usado para autenticação. As entradas aceitas são AccessToken e SharedAccessSignature.

Valores Possíveis

AccessToken, SharedAccessSignature

Tipo de Dados

string

Valor Padrão

"SharedAccessSignature"

Observações

Juntamente com Conta, esse campo é usado para autenticação no serviço. O padrão é AccessToken:

• AccessToken: Indica que a autenticação será feita via AccessKey e Conta.
• SharedAccessSignature: Indica que a autenticação será feita via SharedAccessSignature e Conta. Geralmente Tabelas também deve ser definido.

Processo Interno

O back-end onde os dados são armazenados.

Valores Possíveis

AzureStack, CosmosDB, Storage, Emulator

Tipo de Dados

string

Valor Padrão

"Storage"

Observações

Os dados podem ser recuperados do repositório clássico de armazenamento de tabelas do Azure, do emulador de armazenamento do Azure ou do CosmosDB. Como alternativa, você pode especificar AzureStack se estiver usando Azure Stack Hub. Se você optar por fazê-lo, especifique a Conta como o hospedar completo para seus dados. Por exemplo: <account>.nm.azs.sandia.gov.

Se você escolher Emulador, especifique a Conta e SharedAccessSignature propriedade de conexão.

SharedAccessAssinatura

Uma assinatura de chave de acesso compartilhado que pode ser usada para autenticação.

Tipo de Dados

string

Valor Padrão

""

Observações

Uma assinatura de acesso compartilhado. Pode ser usado em vez de uma AccessKey para acessar recursos.

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%\\\AzureTables 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%\\AzureTables 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.

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

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

Ao usar SharedAccessSignature, em geral o Tables deve ser definido para especificar a qual recurso a assinatura se destina.

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

Diversos

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

GenerateSchemaFiles

Indica a preferência do usuário quanto a quando os esquemas devem ser gerados e salvos.

Valores Possíveis

Never, OnUse, OnStart, OnCreate

Tipo de Dados

string

Valor Padrão

"Never"

Observações

Esta propriedade gera esquemas para arquivos .rsd no caminho especificado por Location.

As configurações disponíveis são as seguintes:

• Nunca: Um arquivo de esquema nunca será gerado.
• OnUse: Um arquivo de esquema será gerado na primeira vez que uma tabela for referenciada, desde que o arquivo de esquema para a tabela ainda não exista.
• OnStart: Um arquivo de esquema será gerado no momento da conexão para todas as tabelas que atualmente não possuem um arquivo de esquema.
• OnCreate: Um arquivo de esquema será gerado ao executar uma consultar SQL CREATE TABLE.

Observe que, se você deseja gerar novamente um arquivo, primeiro precisará excluí-lo.

Gerar Esquemas com SQL

Ao definir GenerateSchemaFiles para OnUse, o conector gera esquemas conforme você executa consultas SELECT. Os esquemas são gerados para cada tabela referenciada na consultar.

Ao definir GenerateSchemaFiles para OnCreate, os esquemas são gerados apenas quando uma consultar CREATE TABLE é executada.

Gerar Esquemas na Conexão

Outra maneira de usar essa propriedade é obter esquemas para cada tabela em seu banco de dados quando você se conectar. Para isso, defina GenerateSchemaFiles para OnStart e conecte.

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, "*=*".

RowScanDepth

O número máximo de linhas a serem verificadas para procurar as colunas disponíveis em uma tabela.

Tipo de Dados

int

Valor Padrão

50

Observações

As colunas em uma tabela devem ser determinadas pela varredura das linhas da tabela. Esse valor determina o número máximo de linhas que serão verificadas.

Definir um valor alto pode diminuir o desempenho. Definir um valor baixo pode impedir que o tipo de dados seja determinado corretamente, especialmente quando houver dados nulos.

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.

TipoDetecçãoEsquema

Determina como determinar o tipo de dados das colunas.

Valores Possíveis

None, RowScan

Tipo de Dados

string

Valor Padrão

"RowScan"

Observações