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 (consulte o Windows 8 e o Windows Server 2012 Compatibility Cookbook para obter mais detalhes). Os componentes do cliente RDS serão removidos em uma versão futura do Windows. Evite usar esse recurso em um novo trabalho de desenvolvimento e planeje modificar aplicativos que atualmente usam esse recurso. Os aplicativos que usam o serviço RDS devem migrar para WCF Data Service.
A nova cadeia de caracteres SQL pode ser parametrizada. Ou seja, os parâmetros na cadeia de caracteres SQL da seção sql (designados pelo caractere '?') podem ser substituídos por argumentos correspondentes a um identificador em na cadeia de caracteres do comando do cliente (designada 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 está [SQL CustomerByID]e a nova cadeia de caracteres da seção SQL é "SELECT * FROM Customers WHERE CustomerID = ?". o Manipulador 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, a execução da instrução falhará. O parâmetro do cliente é efetivamente ignorado. Você pode fazer isso intencionalmente para "desativar" todos os comandos SQL do cliente especificando:
[SQL default]
SQL = " "
Sintaxe
Uma entrada de cadeia de caracteres SQL de substituição é no formato:
SQL=
sqlString
| Parte | Descrição |
|---|---|
| SQL | Uma cadeia de caracteres literal que indica que se trata de 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 Arquivo de Personalização Conexão
Seção de Logs de Arquivos de Personalização
Seção UserList do arquivo de personalização
Personalização do DataFactory
Configurações Necessárias do Cliente
noções básicas sobre o arquivo de personalização
escrevendo seu próprio manipulador personalizado