Guia de Implementação › Especificações de configuração do conector › Seção da interface SQL

Seção da interface SQL

Os conectores do SQL podem ser usados para recuperar dados de bancos de dados usando uma instrução SQL.

A interface do SQL define a conexão com o banco de dados e as consultas usadas para recuperar os dados como segue:

Estrutura do XML:

	< DataSourceInterface >
		<ConnectionString ConnectionTimeout="60" QueryTimeout="30">
			<![CDATA[ Driver={Microsoft Access Driver (*.mDataBase)};DataBaseq=d:\Oblicore\database1.mdatabase; ]]>
			</ConnectionString>
		<QueryCollection>
		<Query QueryName="cases" InputFormat="cases" SleepTime="3600">
			<SelectStatement AutoCompleteQuery="yes">
			select dateclosed,callid,dateopened,companyname,priority,closedmn,responsemn
			from calls where dateclosed is not NULL
			</SelectStatement>
		<QueryKeyFields>
			<KeyField Name="dateclosed" Sort="asc"/>
			<KeyField Name="callid" Sort="desc"/>
			<SelectInitialValues>
				Select min(dateclosed) , 'min date' from calls
			</SelectInitialValues>
		</QueryKeyFields>
	</Query>
	<Query QueryName="contracts" InputFormat="contracts" SleepTime="3600">
	<ConnectionString>
		<Segment Type="text"
		Text=" Driver={Microsoft Excel Driver (*.xls)}; DriverId=790; DataBaseq="/>
		<Segment Type="File">
		<File Path="d:\Oblicore " NamePattern="Availabilty_*.XLS>
		</Segment>
		<Segment Type="text" Text=";"/>
	</ConnectionString>
<SelectStatement AutoCompleteQuery="yes">….</SelectStatement>
<QueryKeyFields>…..</QueryKeyFields>
</Query>
</QueryCollection>
</DataSourceInterface>

• ConnectionString - texto da conexão para acesssar o banco de dados de origem.

  ConnectionString pode ser definido no elemento DataSourceInterface e/ou nos elementos da consulta. A definição de ConnectionString no elemento DataSourceInterface é o padrão e é usada apenas em uma consulta sem a definição de ConnectionString.

  O texto da conexão pode ser definido em uma sequência de caracteres ou por segmentos. Quando o elemento ConnectionString não contém elementos de segmento, o texto da conexão é obtido a partir do texto do elemento ConnectionString. Se ele contém pelo menos um elemento de segmento, o texto da conexão é concatenado a partir dele.

  Há dois tipos de segmento. O primeiro é texto e contém texto concatenado ao texto da conexão na forma em que se encontra. O segundo é arquivo e contém um nome de arquivo com ou sem caracteres curinga. O segmento do arquivo pode aparecer apenas uma vez e contém outros atributos que definem o que fazer com o arquivo de leitura.

  • ConnectionTimeout (opcional) - especifica o número inteiro positivo que indica, em segundos, quanto tempo aguardar até abrir a conexão. O valor 0 indica que se deve aguardar indefinidamente até que a conexão seja aberta. O valor padrão é 15 segundos.

  Observação: alguns provedores não oferecem suporte a essa funcionalidade.

  • QueryTimeout (opcional) - especifica o número inteiro positivo que indica, em segundos, quanto tempo aguardar até executar a consulta. O valor 0 indica que se deve aguardar indefinidamente até que a execução esteja concluída. O valor padrão é 30 segundos.

  Observação: alguns provedores não oferecem suporte a essa funcionalidade.

  • Segment - especifica os atributos do segmento.
  • Type (text, file) (opcional) - especifica o tipo de segmento.
  • Text - especifica o texto do segmento de texto.
  • File - especifica os atributos do arquivo.
  • Path - especifica o caminho dos arquivos da origem de dados.
  • NamePattern - especifica o nome do arquivo de origem de dados e aceita caracteres curinga.
  • InitialFileName (opcional) - Informa ao usuário a partir de qual arquivo iniciar a pesquisa e o padrão a ser pesquisado.
  • UsePath [yes, no] (opcional) - quando definido como yes, o caminho do arquivo é concatenado com o texto da conexão.
  • UseFileName [yes/no] (opcional) - quando definido como yes, o nome do arquivo é concatenado com o texto da conexão (necessário para arquivos em Excel).
  • UpdateSchemaFile [yes/no] (opcional) - quando definido como yes, o conector atualiza o arquivo schema.ini com o nome de arquivo atual.

  Observação: use este atributo apenas quando desejar que o conector altere o arquivo schema.ini (banco de dados para arquivo de texto).

• QueryCollection - especifica um conjunto de consultas (é possível definir mais de uma consulta por conector).
  • PreliminaryCheck-: (opcional [sim/não]). o conector verifica as consultas ao conectar-se ao banco de dados. Se este atributo estiver definido como "no", o conector verificará as consultas executando-as sem nenhuma alteração. Em seguida, o conector é executado nos registros de retorno e não os lê novamente. Se definido como "yes", o conector substitui cada ocorrência de "where" na instrução selecionada por "where 1=2 and" e só então executa as consultas. Use esta opção caso deseje verificar todas as consultas antes de o conector iniciar a execução de todos os registros e quando esta adição reduzir drasticamente o tempo da consulta. Note - alguns provedores não otimizam o processo de consulta, e quando a consulta é válida, a execução leva o mesmo tempo que levaria sem a adição.
  • ExternalCommand (opcional) - especifica o comando externo executado antes de o conector iniciar outro ciclo de leitura.
  • Command - especifica o nome do arquivo em lote a ser executado.
  • SleepTime - especifica um número inteiro positivo que indica, em segundos, quanto tempo esperar até executar o comando novamente.
• Query - especifica os atributos da pesquisa.
  • QueryName - especifica o nome da consulta.
  • IsActive [yes/no] (opcional) - quando definido como "no", o conector não lê registros a partir deste arquivo.
  • InputFormat - especifica o formato de entrada associado a esta consulta. O conector usa o atributo InputFormat para extrair dados do registro de origem.
  • SleepTime - especifica o período, em segundos, durante o qual o conector é desativado enquanto aguarda a chegada de novos dados.
  • Critical [yes/no] (opcional) - se definido como "yes", o conector é interrompido imediatamente ao encontrar um erro na consulta. A opção "no" é usada quando há um erro conhecido que pode ser resolvido sem que se altere o arquivo de configuração.
  • TransactionMode [implicit/explicit] (opcional) - se definido como "explicit", o conector inicia uma transação no banco de dados antes da consulta. Essa opção resolve vários problemas em consultas extensas e complicadas.
  • RollbackSegementName (opcional) - define qual segmento de reversão o conector usa. Caso contrário, o banco de dados é que seleciona o segmento de reversão.
• SelectStatement: contém a declaração selecionada para ser executada no banco de dados de origem.
  • AutoCompleteQuery-(Optional) [yes/no] - se definido como "yes", o conector concatena automaticamente uma instrução where com a consulta especificada que procede da seguinte maneira:
  • Cria uma instrução where que retornará apenas valores novos com base em campos chave.
  • Ordena os resultados da instrução com base em campos chave.
• QueryKeyFields - define os campos que iniciarão a próxima recuperação de dados.
  • KeyField:
  • Name - especifica o nome do campo obtido dos campos da consulta.
  • Sort [asc/desc] (opcional) - especifica o método de classificação dos dados (crescente/decrescente).
  • Function (opcional) - use este atributo se for necessário que uma função especial opere neste campo. Para combinar o valor do campo na função, use (:fieldname). Por exemplo, usar a função de data do Oracle com um campo chamado Ts-Function="to_date(':ts','dd/mm/yyy')"
  • ValueLeftWrapper (opcional) - use este atributo para concatenar caracteres antes do valor do campo. O padrão para os campos de texto e data é "'" (apóstrofe).
  • ValueRightWrapper (opcional) - use este atributo para concatenar caracteres depois do valor do campo. O padrão para os campos de texto e data é "'" (apóstrofe).
  • NameLeftWrapper (opcional) - use este atributo para concatenar caracteres antes do nome do campo. O padrão é a sequência de caracteres nula.
  • NameRightWrapper (opcional) - use este atributo para concatenar caracteres depois do nome do campo. O padrão é a sequência de caracteres nula.
  • IsPrimaryKey [yes/no] (opcional) - quando definido como "no", esta chave não é usada pelo conector na instrução where automática na consulta.
  • DefaultInitialValue (opcional) - se a consulta SelectInitialValues não retornar nenhum registro, é deste atributo que o conector obtém o padrão. Se houver campos chave, todos eles deverão ter este atributo.
  • SelectInitialValues - especifica uma instrução que fornece os valores iniciais para a primeira instrução where (quando o arquivo de controle está vazio).

  Observação: a ordem dos valores deve ser a mesma que a dos elementos do campo para QueryKeyFields e deve retornar um resultado para cada campo.