Visão geral do provedor de comunicação remota do Microsoft OLE DB
O Provedor de Comunicação Remota do Microsoft OLE DB permite que um usuário local em um computador cliente invoque provedores de dados em um computador remoto. Especifique os parâmetros do provedor de dados para o computador remoto como faria se fosse um usuário local no computador remoto. Em seguida, especifique os parâmetros usados pelo Provedor de Comunicação Remota para acessar o computador remoto. Em seguida, você pode acessar o computador remoto como se fosse um usuário local.
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.
Palavra-chave do provedor
Para invocar o Provedor de Comunicação Remota OLE DB, especifique a palavra-chave e o valor a seguir na string de conexão. (Observe o espaço em branco no nome do provedor.)
"Provider=MS Remote"
Palavras-chave adicionais
Quando esse provedor de serviços é invocado, as palavras-chave adicionais a seguir são relevantes.
| Palavra-chave | Descrição |
|---|---|
| Fonte de Dados | Especifica o nome da fonte de dados remota. Ele é passado para o Provedor de Comunicação Remota OLE DB para processamento. Essa palavra-chave é equivalente à propriedade Connect do objeto RDS.DataControl. |
Propriedades dinâmicas
Quando esse provedor de serviços é invocado, as propriedades dinâmicas a seguir são adicionadas à coleção Propriedades do do objeto connection do.
| Nome da propriedade dinâmica | Descrição |
|---|---|
| DFMode | Indica o modo DataFactory. Uma cadeia de caracteres que especifica a versão desejada do objeto DataFactory no servidor. Defina essa propriedade antes de abrir uma conexão para solicitar uma versão específica do DataFactory. Se a versão solicitada não estiver disponível, será feita uma tentativa de usar a versão anterior. Se não houver nenhuma versão anterior, ocorrerá um erro. Se DFMode for menor do que a versão disponível, ocorrerá um erro. Essa propriedade é somente leitura depois que uma conexão é feita. Pode ser um dos seguintes valores de cadeia de caracteres válidos: - "25"-Versão 2.5 (padrão) - "21"-Versão 2.1 - "20"-Versão 2.0 - "15"-Versão 1.5 |
| Propriedades do comando | Indica valores que serão adicionados à cadeia de caracteres de propriedades de comando (conjunto de linhas) enviadas ao servidor pelo provedor MS Remote. O valor padrão dessa cadeia de caracteres é vt_empty. |
| Modo DF atual | Indica o número de versão real do DataFactory no servidor. Verifique esta propriedade para confirmar se a versão solicitada na propriedade DFMode foi respeitada. Pode ser um dos seguintes valores inteiros long válidos: - Versão 25 2.5 (padrão) - 21-Versão 2.1 - 20-Versão 2.0 - 15-Versão 1.5 Adicionar "DFMode=20;" à cadeia de conexão ao usar o provedor de MSRemote pode melhorar o desempenho do servidor ao atualizar dados. Com essa configuração, o objeto RDSServer.DataFactory no servidor usa um modo menos intensivo de recursos. No entanto, os seguintes recursos não estão disponíveis nesta configuração: - Usando consultas parametrizadas. – Obtendo informações de parâmetro ou coluna antes de chamar o método Executar. - Definindo de Atualizações de Transação para True. - Obtendo o status da linha. - Chamando o método de ressincronização . - Atualizando (explicitamente ou automaticamente) por meio da propriedade Update Resync. – Definindo de comando ou propriedades de do conjunto de registros. - Usando adCmdTableDirect. |
| Manipulador | Indica o nome de um programa de personalização do lado do servidor (ou manipulador) que estende a funcionalidade do RDSServer.DataFactorye todos os parâmetros usados pelo manipulador, todos separados por vírgulas (","). Um valor de cadeia de caracteres . |
| de Tempo Limite da Internet | Indica o número máximo de milissegundos para aguardar o tempo de ida e volta de uma solicitação ao servidor. (O padrão é 5 minutos.) |
| do provedor remoto | Indica o nome do provedor de dados a ser usado no servidor remoto. |
| Servidor Remoto | Indica o nome do servidor e o protocolo de comunicação a ser usado por essa conexão. Essa propriedade é equivalente à propriedade do objeto RDS.DataControservidor. |
| Atualizações do Transact | Quando definido como True em , esse valor indica que, quando o UpdateBatch é executado no servidor, ele será realizado dentro de uma transação. O valor padrão dessa propriedade dinâmica booliana é False. |
Você também pode definir propriedades dinâmicas graváveis especificando seus nomes como palavras-chave na cadeia de conexão. Por exemplo, defina a propriedade dinâmica Internet Timeout como cinco segundos especificando:
Dim cn as New ADODB.Connection
cn.Open "Provider=MS Remote;Internet Timeout=5000"
Você também pode definir ou recuperar uma propriedade dinâmica especificando seu nome como o índice para a propriedade Properties. O exemplo a seguir mostra como obter e imprimir o valor atual da propriedade dinâmica Internet Timeout e definir um novo valor:
Debug.Print cn.Properties("Internet Timeout")
cn.Properties("Internet Timeout") = 5000
Observações
No ADO 2.0, o Provedor de Comunicação Remota OLE DB só pode ser especificado no parâmetro ActiveConnection do método Open do objeto Recordset. A partir do ADO 2.1, o provedor também pode ser especificado no parâmetro ConnectionString do objeto Connection do método Open.
O equivalente do RDS . O objeto DataControl propriedade sql não está disponível. O objeto Recordsetmétodo OpenOrigem argumento é usado.
Observação Especificar "...; Remote Provider=MS Remote;..." criaria um cenário de quatro camadas. Cenários além de três camadas não foram testados e não devem ser necessários.
Exemplo
Este exemplo executa uma consulta na tabela Authors do banco de dados Pubs em um servidor chamado YourServer. Os nomes da fonte de dados remota e do servidor remoto são fornecidos no método Open do objeto Connection e a consulta SQL é especificada no método Open do objeto Recordset. Um objeto Recordset é retornado, editado e usado para atualizar a fonte de dados.
Dim rs as New ADODB.Recordset
Dim cn as New ADODB.Connection
cn.Open "Provider=MS Remote;Data Source=pubs;" & _
"Remote Server=https://YourServer"
rs.Open "SELECT * FROM authors", cn
... 'Edit the recordset
rs.UpdateBatch 'Equivalent of RDS SubmitChanges
...
Consulte Também
visão geral do provedor de comunicação remota OLE DB