Seção SQL do arquivo de personalização
A seção sql pode conter uma nova cadeia de caracteres SQL que substitui a cadeia de caracteres de comando do cliente. Se não houver nenhuma cadeia de caracteres SQL na seção, a seção será ignorada.
Importante
A partir do Windows 8 e do Windows Server 2012, os componentes do servidor RDS não estão mais incluídos no sistema operacional Windows (confira Windows 8 e Manual de Compatibilidade do Windows Server 2012 para obter mais detalhes). Os componentes do cliente RDS serão removidos em uma versão futura do Windows. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. Os aplicativos que usam o RDS devem migrar para o Serviço de Dados do WCF.
A nova cadeia de caracteres SQL pode ser parametrizada. Ou seja, os parâmetros da cadeia de caracteres SQL da seção sql (designada pelo caractere '?') podem ser substituídos por argumentos correspondentes em um identificador na cadeia de caracteres de comando do cliente (designado por uma lista delimitada por vírgulas em parênteses). O identificador e a lista de argumentos se comportam como uma chamada de função.
Por exemplo, suponha que a cadeia de caracteres de comando do cliente seja "CustomerByID(4)", o cabeçalho da seção SQL seja [SQL CustomerByID] e a nova cadeia de caracteres da seção SQL seja "SELECT * FROM Customers WHERE CustomerID = ?".. O manipulador vai gerar "SELECT * FROM Customers WHERE CustomerID = 4" e usar essa cadeia de caracteres para consultar a fonte de dados.
Se a nova instrução SQL for a cadeia de caracteres nula (""), a seção será ignorada.
Se a nova cadeia de caracteres de instrução SQL não for válida, ocorrerá uma falha na execução da instrução. O parâmetro do cliente é efetivamente ignorado. Faça isso intencionalmente para "desativar" todos os comandos SQL do cliente especificando:
[SQL default]
SQL = " "
Syntax
Uma entrada de cadeia de caracteres SQL de substituição tem o formato:
SQL=
sqlString
| Parte | Descrição |
|---|---|
| SQL | Uma cadeia de caracteres literal que indica que essa é uma entrada de seção SQL. |
| sqlString | Uma cadeia de caracteres SQL que substitui a cadeia de caracteres do cliente. |
Consulte Também
Seção Conexão do arquivo de personalização
Seção Logs do arquivo de personalização
Seção UserList do arquivo de personalização
Personalização do DataFactory
Configurações necessárias de cliente
Noções básicas sobre o arquivo de personalização
Escrever seu próprio manipulador personalizado