Introducción al proveedor OLE DB de Microsoft para ODBC

Para un programador de ADO o RDS, lo ideal sería que cada origen de datos exponga una interfaz OLE DB, de modo que ADO pudiera llamar directamente al origen de datos. Aunque cada vez más proveedores de bases de datos implementan interfaces OLE DB, algunos orígenes de datos aún no se exponen de esta manera. Sin embargo, se puede acceder a la mayoría de los sistemas DBMS que se usan hoy en día a través de ODBC.

Los controladores ODBC están disponibles para todos los DBMS principales que se usan hoy en día, incluidos Microsoft SQL Server, Microsoft Access (motor de base de datos de Microsoft Jet) y Microsoft FoxPro, además de productos de base de datos que no son de Microsoft, como Oracle.

Sin embargo, el proveedor ODBC de Microsoft permite a ADO conectarse a cualquier origen de datos ODBC. El proveedor está habilitado para subprocesos gratuitos y Unicode.

El proveedor admite transacciones, aunque los distintos motores de DBMS ofrecen diferentes tipos de compatibilidad con transacciones. Por ejemplo, Microsoft Access admite transacciones anidadas de hasta cinco niveles de profundidad.

Este es el proveedor predeterminado para ADO, y se admiten todas las propiedades y métodos de ADO dependientes del proveedor.

Parámetros de cadena de conexión

Para conectarse a este proveedor, establezca el argumento Provider= de la propiedad ConnectionString en:

MSDASQL

Al leer la propiedad proveedor, también se devolverá esta cadena.

Cadena de conexión típica

Una cadena de conexión típica para este proveedor es:

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

La cadena consta de estas palabras clave:

Dado que este es el proveedor predeterminado para ADO, si omite el parámetro Provider= de la cadena de conexión, ADO intentará establecer una conexión con este proveedor.

El proveedor no admite ningún parámetro de conexión específico del proveedor, aparte de los definidos por ADO. Sin embargo, el proveedor pasará los parámetros de conexión que no sean de ADO al administrador de controladores ODBC.

Dado que puede omitir el parámetro Provider, puede crear una cadena de conexión de ADO idéntica a una cadena de conexión ODBC para el mismo origen de datos. Use los mismos nombres de parámetro (DRIVER=, DATABASE=, DSN=, etc.), los valores y la sintaxis que usaría para crear una cadena de conexión ODBC. Puede conectarse con o sin un nombre de origen de datos predefinido (DSN) o FileDSN.

Sintaxis con un DSN o FileDSN:

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

Sintaxis sin un DSN (conexión sin DSN):

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

Observaciones

Si usa un DSN o FileDSN, debe definirlos a través del administrador de orígenes de datos ODBC en el Panel de control de Windows. En Microsoft Windows 2000, el Administrador de ODBC se encuentra en Herramientas administrativas. En versiones anteriores de Windows, el icono del Administrador de ODBC se denomina ODBC de 32 bits o simplemente ODBC.

Como alternativa a establecer un DSN, puede especificar el controlador ODBC (DRIVER=), como "SQL Server;" el nombre del servidor (SERVER=) y el nombre de la base de datos (DATABASE=).

También puede especificar un nombre de cuenta de usuario (UID=) y la contraseña de la cuenta de usuario (PWD=) en los parámetros específicos de ODBC o en los parámetros de usuario y contraseña definidos por ADO estándar.

Aunque una definición de DSN ya especifica una base de datos, puedes especificar un parámetro database además de un DSN para conectarte a otra base de datos. Es recomendable incluir siempre el parámetro database cuando se usa un DSN. Esto garantizará que se conecte a la base de datos correcta si otro usuario cambió el parámetro de base de datos predeterminado desde la última vez que comprobó la definición de DSN.

Propiedades de conexión específicas del proveedor

El proveedor OLE DB para ODBC agrega varias propiedades a la colección Properties del objeto Connection. En la tabla siguiente se enumeran estas propiedades con el nombre de propiedad OLE DB correspondiente entre paréntesis.

Provider-Specific Propiedades de conjunto de registros y comandos

El proveedor OLE DB para ODBC agrega varias propiedades a la colección Properties de los objetos Recordset y Command. En la tabla siguiente se enumeran estas propiedades con el nombre de propiedad OLE DB correspondiente entre paréntesis.

Texto del comando

La forma en que se usa el objeto Command depende en gran medida del origen de datos y del tipo de consulta o la instrucción de comando que aceptará.

ODBC proporciona una sintaxis específica para llamar a procedimientos almacenados. Para la propiedad CommandText de un objeto Command, el argumento CommandText para el método Execute en un objeto Connection o el argumento Source para el método Open en un objeto Recordset, pasa una cadena con esta sintaxis:

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

Cada ? hace referencia a un objeto de la colección Parameters. El primer ? hace referencia a Parameters(0), y el siguiente ? hace referencia a Parameters(1), etc.

Las referencias de parámetro son opcionales y dependen de la estructura del procedimiento almacenado. Si desea llamar a un procedimiento almacenado que no define ningún parámetro, la cadena tendría el siguiente aspecto:

"{ call procedure }"

Si tiene dos parámetros de consulta, la cadena sería similar a la siguiente:

"{ call procedure ( ?, ? ) }"

Si el procedimiento almacenado devuelve un valor, el valor devuelto se trata como otro parámetro. Si no tiene parámetros de consulta, pero tiene un valor devuelto, la cadena sería similar a la siguiente:

"{ ? = call procedure }"

Por último, si tiene un valor devuelto y dos parámetros de consulta, la cadena sería similar a la siguiente:

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

Comportamiento del conjunto de registros

En las tablas siguientes se enumeran los métodos y propiedades de ADO estándar disponibles en un objeto Recordset abierto con este proveedor.

Para obtener información más detallada sobre el comportamiento de Recordset para la configuración de su proveedor, ejecute el método Supports y enumere la colección de Properties del Recordset para determinar si hay propiedades dinámicas específicas del proveedor presentes.

Disponibilidad de las propiedades estándar de objeto Recordset de ADO:

Las propiedades AbsolutePosition y AbsolutePage son de solo escritura cuando se usa ADO con la versión 1.0 del proveedor OLE DB de Microsoft para ODBC.

Disponibilidad de los métodos estándar del conjunto de registros de ADO:

*No se admite para las bases de datos de Microsoft Access.

Propiedades dinámicas

El proveedor OLE DB de Microsoft para ODBC inserta varias propiedades dinámicas en la colección Properties de los objetos Connection, Recordset y Command sin abrir.

Las tablas siguientes son un índice cruzado de los nombres de ADO y OLE DB para cada propiedad dinámica. La referencia del programador OLE DB hace referencia a un nombre de propiedad de ADO por el término "Descripción". Puede encontrar más información sobre estas propiedades en la referencia del programador de OLE DB. Busque el nombre de la propiedad OLE DB en el índice o vea Apéndice C: Propiedades de OLE DB.

Propiedades dinámicas de conexión

Las siguientes propiedades se agregan a la colección Properties del objeto Connection.

Propiedades dinámicas del conjunto de registros

Las siguientes propiedades se agregan a la colección Properties del objeto Recordset.

Propiedades dinámicas de comandos

Las siguientes propiedades se agregan a la colección Properties del objeto Command.

Para obtener más información sobre la implementación específica y la información funcional sobre el proveedor OLE DB de Microsoft para ODBC, consulte la referencia del programador de OLE DB o visite el sitio web del Centro para desarrolladores de almacenamiento y acceso a datos en MSDN.

Véase también

Objeto Command (ADO)Propiedad CommandText (ADO)Objeto Connection (ADO)Propiedad ConnectionString (ADO)Método Execute (comando de ADO)Método Open (Recordset de ADO)Colección Parameters (ADO)Colección Properties (ADO)Propiedad Provider (ADO)Objeto Recordset (ADO)Método Supports