Visão geral de Microsoft OLE DB Provider para ODBC

Para um programador ADO ou RDS, um mundo ideal seria aquele em que cada fonte de dados expõe uma interface OLE DB, de modo que o ADO possa chamar diretamente para a fonte de dados. Embora cada vez mais fornecedores de banco de dados estejam implementando interfaces OLE DB, algumas fontes de dados ainda não são expostas dessa forma. No entanto, a maioria dos sistemas DBMS em uso atualmente pode ser acessada por meio do ODBC.

Os drivers ODBC estão disponíveis para todos os principais DBMS em uso atualmente, incluindo Microsoft SQL Server, Microsoft Access (mecanismo de banco de dados Microsoft Jet) e Microsoft FoxPro, além de produtos de banco de dados não Microsoft, como Oracle.

No entanto, o Provedor ODBC da Microsoft permite que o ADO se conecte a qualquer fonte de dados ODBC. O provedor é de thread livre e Unicode habilitado.

O provedor dá suporte a transações, embora diferentes mecanismos DBMS ofereçam diferentes tipos de suporte a transações. Por exemplo, o Microsoft Access dá suporte a transações aninhadas de até cinco níveis de profundidade.

Esse é o provedor padrão do ADO e há suporte para todas as propriedades e métodos do ADO dependentes do provedor.

Parâmetros de cadeia de conexão

Para se conectar a esse provedor, defina o argumento Provider da propriedade ConnectionString como:

MSDASQL

A leitura da propriedade Provider também retornará essa cadeia de caracteres.

Cadeia de conexão típica

Uma cadeia de conexão típica para esse provedor é:

"Provider=MSDASQL;DSN=dsnName;UID=MyUserID;PWD=<password>;"

A cadeia de caracteres consiste nestas palavras-chave:

Como esse é o provedor padrão do ADO, se você omitir o parâmetro Provider= da cadeia de conexão, o ADO tentará estabelecer uma conexão com esse provedor.

O provedor não dá suporte a quaisquer parâmetros de conexão específicos do provedor, além daqueles definidos pelo ADO. No entanto, o provedor passará todos os parâmetros de conexão não ADO para o gerenciador de driver ODBC.

Como você pode omitir o parâmetro Provider, você pode, portanto, redigir uma cadeia de conexão ADO idêntica a uma cadeia de conexão ODBC para a mesma fonte de dados. Use os mesmos nomes de parâmetro (DRIVER=, DATABASE=, DSN=e assim por diante), valores e sintaxe como faria ao redigir uma cadeia de conexão ODBC. Você pode se conectar com ou sem um DSN (nome de fonte de dados) ou FileDSN predefinido.

Sintaxe com um DSN ou FileDSN:

"[Provider=MSDASQL;] { DSN=name | FileDSN=filename } ;
[DATABASE=database;] UID=user; PWD=<password>"

Sintaxe sem uma DSN (conexão sem DSN):

"[Provider=MSDASQL;] DRIVER=driver; SERVER=server;
DATABASE=database; UID=MyUserID; PWD=<password>"

Comentários

Se você usar um DSN ou FileDSN, ele deverá ser definido por meio do Administrador da Fonte de Dados ODBC no Painel de Controle do Windows. No Microsoft Windows 2000, o Administrador ODBC está localizado em Ferramentas Administrativas. Em versões anteriores do Windows, o ícone administrador ODBC é chamado de ODBC de 32 bits ou apenas ODBC.

Como alternativa à configuração de um DSN, você pode especificar o driver ODBC (DRIVER=), como "SQL Server;" o nome do servidor (SERVER=); e o nome do banco de dados (DATABASE=).

Você também pode especificar um nome de conta de usuário (UID=) e a senha da conta de usuário (PWD=) nos parâmetros específicos do ODBC ou nos parâmetros padrão de usuário e senha definidos pelo ADO.

Embora uma definição de DSN já especifique um banco de dados, você pode especificar um parâmetro de banco de dados além de um DSN para se conectar a um banco de dados diferente. É uma boa ideia sempre incluir o parâmetro de banco de dados quando você usa um DSN. Isso garantirá que você se conecte ao banco de dados correto se outro usuário alterou o parâmetro de banco de dados padrão desde a última vez que você verificou a definição de DSN.

Propriedades de conexão específicos do provedor

O provedor OLE DB para ODBC adiciona várias propriedades à coleção Properties do objeto Connection. A tabela a seguir lista essas propriedades com o nome da propriedade OLE DB correspondente em parênteses.

Propriedades de Recordset e Command específicas do provedor

O provedor OLE DB para ODBC adiciona várias propriedades à coleção Properties dos objetos Recordset e Command. A tabela a seguir lista essas propriedades com o nome da propriedade OLE DB correspondente em parênteses.

Texto do comando

A forma como você usa o objeto Command depende em grande parte da fonte de dados e de que tipo de consulta ou instrução de comando ele aceitará.

O ODBC fornece uma sintaxe específica para chamar procedimentos armazenados. Para a propriedade CommandText de um objeto Command, o argumento CommandText para o método Execute em um objeto Connection ou o argumento Source para o método Open em um objeto Recordset, passa em uma cadeia de caracteres com esta sintaxe:

"{ [ ? = ] call procedure [ ( ? [, ? [ , ... ]] ) ] }"

Cada ? faz referência a um objeto na coleção Parameters. O primeiro ?referencia Parâmetros(0), o próximo ? faz referência a Parâmetros(1) e assim por diante.

As referências de parâmetro são opcionais e dependem da estrutura do procedimento armazenado. Se você quiser chamar um procedimento armazenado que não define parâmetros, sua cadeia de caracteres terá a seguinte aparência:

"{ call procedure }"

Se você tiver dois parâmetros de consulta, sua cadeia de caracteres será semelhante ao seguinte:

"{ call procedure ( ?, ? ) }"

Se o procedimento armazenado retornar um valor, o valor retornado será tratado como outro parâmetro. Se você não tiver parâmetros de consulta, mas tiver um valor retornado, sua cadeia de caracteres será semelhante ao seguinte:

"{ ? = call procedure }"

Por fim, se você tiver um valor de retorno e dois parâmetros de consulta, sua cadeia de caracteres será semelhante ao seguinte:

"{ ? = call procedure ( ?, ? ) }"

Comportamento do Recordset

As tabelas a seguir listam os métodos padrão do ADO e as propriedades disponíveis em um objeto Recordset aberto com esse provedor.

Para obter informações mais detalhadas sobre o comportamento do Recordset para a configuração do provedor, execute o método Supports e enumere a coleção Properties do Recordset para determinar se as propriedades dinâmicas específicas do provedor estão presentes.

Disponibilidade de propriedades padrão do Conjunto de registros ADO:

As propriedades AbsolutePosition e AbsolutePage são somente gravação quando o ADO é usado com a versão 1.0 do Provedor OLE DB da Microsoft para ODBC.

Disponibilidade de métodos padrão do Conjunto de registros ADO:

*Sem suporte para bancos de dados do Microsoft Access.

Propriedades Dinâmicas

O Provedor Microsoft OLE DB para ODBC insere várias propriedades dinâmicas na coleção Properties dos objetos Connection, Recordset e Command não abertos.

As tabelas a seguir são um índice cruzado dos nomes ADO e OLE DB para cada propriedade dinâmica. A Referência do Programador do OLE DB refere-se a um nome de propriedade ADO pelo termo "Descrição". Encontre mais informações sobre essas propriedades na Referência do Programador do OLE DB. Procure o nome da propriedade OLE DB no Índice ou confira Apêndice C: Propriedades do OLE DB.

Propriedades dinâmicas de conexão

As propriedades a seguir são adicionadas à coleção Properties do objeto Connection.

Propriedades dinâmicas do conjunto de registros

As propriedades a seguir são adicionadas à coleção Properties do objeto Recordset.

Propriedades dinâmicas de Command

As propriedades a seguir são adicionadas à coleção Properties do objeto Command.

Para obter detalhes sobre a implementação específica e informações funcionais sobre o Provedor OLE DB da Microsoft para ODBC, consulte a Referência do Programador OLE DB ou visite o site do Centro de Desenvolvedores de Acesso a Dados e Armazenamento no MSDN.

Confira também

Objeto Command (ADO)Propriedade CommandText (ADO)Objeto Connection (ADO)Propriedade ConnectionString (ADO)Método Execute (Comando ADO)Método Open (Recordset ADO)Coleção Parameters (ADO)Coleção Properties (ADO)Propriedade Provider (ADO)Objeto Recordset (ADO)Método de suportes