Noções básicas sobre o arquivo de personalização
Cada cabeçalho de seção no arquivo de personalização consiste em colchetes ([]) contendo um tipo e um parâmetro. Os quatro tipos de seção são indicados pelas cadeias de caracteres literais connect, sql, userlistou logs. O parâmetro é a cadeia de caracteres literal, o padrão, um identificador especificado pelo usuário ou nada.
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 RDS devem migrar para WCF Data Service.
Portanto, cada seção é marcada com um dos seguintes cabeçalhos de seção:
[ connect default ] [ connect
identifier
] [ sql default ] [ sql
identifier
] [ userlist
identifier
] [ logs ]
Os cabeçalhos de seção têm as seguintes partes.
| Parte | Descrição |
|---|---|
| conectar | Uma cadeia de caracteres literal que modifica uma cadeia de conexão. |
| sql | Uma cadeia de caracteres literal que modifica uma cadeia de caracteres de comando. |
| lista de usuários | Uma cadeia de caracteres literal que modifica os direitos de acesso de um usuário específico. |
| registros | Uma cadeia de caracteres literal que especifica um arquivo de log registrando erros operacionais. |
| padrão | Uma cadeia de caracteres literal que será usada se nenhum identificador for especificado ou encontrado. |
| identificador | Uma cadeia de caracteres que corresponde a uma cadeia de caracteres no comando conectar ou cadeia de caracteres. - Use esta seção se o cabeçalho da seção contiver connect e a string do identificador for encontrada na string de conexão. – Use esta seção se o cabeçalho da seção incluir sql e o identificador for encontrado na instrução de comando. - Use esta seção se o cabeçalho da seção contiver userlist e o identificador corresponder a um identificador de seção connect. |
O DataFactory chama o manipulador, passando os parâmetros do cliente. O manipulador pesquisa cadeias de caracteres inteiras nos parâmetros do cliente que correspondem aos identificadores nos cabeçalhos de seção apropriados. Se uma correspondência for encontrada, o conteúdo dessa seção será aplicado ao parâmetro do cliente.
Uma seção específica é usada nas seguintes circunstâncias:
Uma seção de conexão será usada se a parte do valor da palavra-chave da cadeia de conexão do cliente, "Data Source=valor", corresponder a um identificador de seção de conexão .
Uma seção sql é usada se a cadeia de caracteres de comando do cliente contiver uma cadeia que corresponda a um identificador de seção sql.
Uma seção de conexão ou SQL com um parâmetro padrão é usada se não houver identificador correspondente.
Uma seção de lista de usuários é usada se o identificador da seção de lista de usuários corresponder a um identificador de seção de conexão. Se houver uma correspondência, o conteúdo da seção da lista de usuários será aplicado à conexão regida pela seção conectar.
Se a string em uma string de conexão ou string de comando não corresponder ao identificador em nenhum cabeçalho de seção connect ou sql, e não houver cabeçalho de seção connect ou sql com um parâmetro padrão, então a string do cliente será usada sem modificação.
A seção de logs é usada sempre que o DataFactory estiver em operação.
Consulte Também
Customization File Connect Seção
Seção de logs de arquivos de personalização
Seção SQL do arquivo de personalização
Seção UserList do arquivo de personalização
Personalização do DataFactory
Configurações Necessárias do Cliente
Escrevendo seu próprio manipulador personalizado