Conexión a los Proveedores OLE DB desde PowerBuilder 7 y 8

Este documento contiene información sobre cómo preparar y definir los proveedores de datos OLE DB que se entregan con PowerBuilder. Este documento es un suplemento a la información de conectividad que se encuentra en el manual Connecting to Your Database. Contiene más detalles referentes a cómo conectarse a los proveedores de datos OLE DB.

¿Qué es OLE DB?

OLE DB es una interfaz para programación de aplicaciones (API) desarrollado por Microsoft. Está diseñada para proveer acceso a un amplio rango de fuentes de datos. Una fuente de datos consiste de datos que están almacenados en diversos formatos, tales como archivos indexados secuenciales, como Btireve, bases de datos personales, como Paradox, herramientas de productividad tales como hojas de cálculo y correo electrónico, así como bases de datos basadas en SQL.

La arquitectura OLE DB usa el concepto de Consumidores de datos, Proveedores de datos y Proveedores de Servicio. Un Consumidor puede ser cualquier componente de software que use una interfaz OLE DB. Puede ser una aplicación de negocio, una herramienta de desarrollo de software, como PowerBuilder, o un lenguaje de programación. Un Proveedor brinda la comunicación entre el consumidor y la fuente de datos como tal. Un Proveedor de Servicio (también conocido como Componente de Servicio) puede brindar funcionalidad extendida de DBMS.

Ventajas de OLE DB vs. ODBC

OLE DB está diseñado para tener acceso a datos no relacionales, tales como mail, así como a datos relacionales basados en SQL. El estándar ODBC provee un camino unificado para tener acceso sólo a datos SQL.

Preparación para usar la interfaz OLE DB

Los siguientes pasos son necesarios para conectarse a un proveedor OLE DB:

• Instale y configure el servidor de bases de datos, el software de red y el software cliente

• Instale la interfaz OLE DB

• Instale los componentes de acceso a datos de Microsoft

• Defina los proveedores OLE DB

• Defina la interfaz OLE DB

Instale y configure el servidor de bases de datos, el software de red y el software cliente

Usted debe obtener el software de base de datos de su proveedor. Para la instalación consulte la documentación del producto.

Para la instalación del software de red, póngase en contacto con su administrador de red.

Para determinar los requerimientos de software cliente, consulte la documentación de su proveedor de datos. La mayor parte de los proveedores requieren que el software cliente esté instalado.

Instale la interfaz OLE DB

Solo PowerBuilder Enterprise incluye la interfaz OLE DB. Para instalar la interfaz OLE DB, selecciones la opción de instalación Custom y seleccione la interfaz OLE DB. La librería PBOLExx.DLL (donde xx es la versión de PowerBuilder) será instalada en \Program Files\Sybase\Shared\PowerBuilder (asumiendo que todas las rutas predeterminadas fueron seleccionadas durante la instalación).

PowerBuilder 7.0 Enterprise instalará Proveedores Intersolv para Informix 7, Informix 9, Oracle 7, Oracle 8 y Sybase.

PowerBuilder 8.0 Enterprise instalará Proveedores Merant para Informix, Oracle 7, Oracle 8i y Sybase.

La versión inicial de la interfaz OLE DB de PowerBuilder no soportará los proveedores Intersolv Reflector y Notes, los que son usados para tener acceso a datos no basados en SQL.

Instale los componentes de acceso a datos de Microsoft (MDAC)

PowerBuilder incluye los componentes de acceso a datos de Microsoft (MDAC) que son requeridos para usar la funcionalidad OLE DB de PowerBuilder. Para instalar MDAC, usted debe ejecutar mdac_min.exe que se encuentra en el directorio \Support del CD de instalación Número 2. Adicionalmente a la instalación de los componentes OLE DB, mdac_min.exe instala los siguientes proveedores OLE DB de Microsoft:

• Proveedor Microsoft OLE DB para ODBC (MSDASQL.DLL)

• Proveedor Microsoft OLE DB para SQL Server (SQLOLEDB.DLL)

Los archivos arriba mencionados son instalados en el directorio \Program Files\Common Files\System\OLE DB.

Nota: El proveedor Microsoft OLE DB para Oracle (MSDAORA.DLL) no se incluye en mdac_min.exe. En su lugar, use el proveedor Intersolv para Oracle.

Defina los proveedores OLE DB

Dependiendo de cuál proveedor y vendedor esté usted usando, usted debe configurar el origen de datos (data source) antes de definir la interfaz OLE DB dentro de la configuración de Perfil de la Base de Datos (Database Profile).

Proveedores Intersolv PowerBuilder 7.0
Para definir un Data Source a través del Administrador OLE DB de Intersolv, usted necesita ejecutar el programa pbadmin.exe desde \Program Files\Sybase\Shared\IntersolvOLEDB.

Siga estos pasos para crear la fuente de datos:

• Haga clic derecho en la carpeta Connect OLE DB Data Source y seleccione New Connect OLE DB Data Source del menú desplegable.

• Escriba un nombre para la fuente de datos en la ventana del proveedor Intersolv Connect OLE DB. Todas las fuentes de datos ubicadas en el mismo directorio deben tener nombres diferentes.

• Seleccione un proveedor de datos de la lista de proveedores de datos instalados en la lista desplegable Provider.

• Haga clic en el botón Set Up Data Source y de la información adicional de conectividad.

Provedores Merant PowerBuilder 8.0
Para definir un Data Source a través del Administrador OLE DB de Merant, usted necesita ejecutar el programa pbadmin.exe desde \Program Files\Sybase\Shared\MerantOLEDB.

Siga estos pasos para crear la fuente de datos:

• Haga clic derecho en la carpeta Connect OLE DB Data Source y seleccione New Connect OLE DB Data Source del menú desplegable.

• Escriba un nombre para la fuente de datos en la ventana del proveedor Merant Connect OLE DB. Todas las fuentes de datos ubicadas en el mismo directorio deben tener nombres diferentes.

• Seleccione un proveedor de datos de la lista de proveedores de datos instalados en la lista desplegable Provider.

• Haga clic en el botón Set Up Data Source y de la información adicional de conectividad.

En la medida en que usted configura cada fuente de datos, asegúrese de verificar su conexión. Haga esto haciendo clic en el botón Test Connection de la pestaña General de la ventana Provider Setup. Esto le asegurará que la conexión está apropiadamente configurada fuera de PowerBuilder y eliminará la posibilidad de errores de conexión.

Proveedores Microsoft
Si usted está usando el Proveedor Microsoft OLE DB para ODBC, usted debe crear un data source a través del Adminitrador ODBC de la misma manera en que lo haría si estuviera usando una conexión directa ODBC. Este utilitario puede ser ejecutado desde el Panel de Control de Windows o desde el painter de base de datos (database painter) de PowerBuilder.

Si usted está usando el Proveedor Microsoft OLE DB para SQL Server 7.0, usted no tiene que configurar un origen de datos. La conexión será directa.

Defina la interfaz OLE DB

Hay seis parámetros DBParms básicos que es necesario definir de tal manera que se pueda realizar la conexión al proveedor OLE DB de PowerBuilder. Los siguientes parámetros pueden ser encontrados en la pestaña Connection de la configuración de perfiles (Profile Setup) para OLE DB:

1. Profile Name -- Nombre del perfil de conectividad

2. Proveedor -- Haga clic sobre la flecha de dirección hacia abajo para seleccionar el proveedor al cual usted se está conectando

3. Data Source -- Esto varía de acuerdo a cual vendedor este usted usando

Intersolv
Si usted está usando un proveedor Intersolv, el nombre del origen del Data Source que usted especifique será igual al nombre del Data Source que usted creó a través del administrador OLE DB. Haga clic en la flecha de dirección hacia abajo para ver todos los orígenes de datos para un proveedor en particular.

Microsoft

Nombre del Proveedor	Base de Datos	Valor de Data Source en el perfil de base de datos
MSDASQL	ODBC	El nombre del data source a través del administrador ODBC
SQLOLEDB	SQL Server 7.0	El nombre del SQL Server
MSDAORA (si está disponible)	Oracle	El nombre del servidor Oracle

4. User ID -- Identificación del usuario, requerida para conectarse a la base de datos

5. Password -- Contraseña o clave, necesaria para conectarse a la base de datos

6. Extended Properties -- La opción puede ser usada para definir la base de datos a la cual usted se va a conectar al usar el proveedor SQLOLEDB. Por ejemplo, escriba database=pubs, para conectarse a la base de datos pubs.

Para información adicional sobre DBParms, consulte al manual Connecting to Your Database.

Interfaces de Objeto de OLE DB
Un proveedor OLE DB debe soportar ciertas Interfaces de Objeto OLE DB para ajustarse a la especificación OLE DB 2.0 de Microsoft. Estas interfaces también son necesarias para conectar el proveedor desde PowerBuilder.

Algunos vendedores no soportan ciertas interfaces adicionales de OLE DB. Si éste es el caso, usted obtendrá un mensaje diciendo que el proveedor no soporta la interfaz y que usted no podrá ejecutar cierta función.

Mensajes de Error Comunes

"The current providre does not support the ITablewDefinition interface which is used to create/drop/alter tables."
Este error ocurre si el proveedor no soporta la interfaz iTableDefinition. Esto puede suceder cuando usted usa la interfaz OLE DB para conectarse a su base de datos por primera vez desde PowerBuilder. En la conexión inicial a una base de datos, PowerBuilder intenta crear unas tablas de catálogo y si el proveedor no soporta la interfaz iTableDefinition, estas tablas no pueden ser creadas. Para remediar este problema, use el controlador (driver) nativo de PowerBuilder para realizar la conexión inicial y crear las tablas de catálogo. Luego conéctese a esa base de datos usando el driver OLE DB.

Si las tablas existen y usted continúa recibiendo éste mensaje, asegúrese de definir adecuadamente el dueño de las tablas de catálogo de PowerBuilder (PowerBuilder Catalog Owner) en la pestaña System del perfil.

Nota: En la mayor parte de los casos, usted podrá crear las tablas desde el painter de base de datos, aún si el mensaje aparece en la conexión inicial.

"SQLState = IM002
Microsoft OLE DB Provider for ODBC drivers
[Microsoft][ODBC Driver Manager] Data Source name not found and no default driver specified"
Este mensaje de error ocurre cuando el nombre del data source especificado en el perfil de la base de datos no es el mismo que el nombre definido en el administrador ODBC.

"SQL State = S1000
[Intersolv][ODBC ODBC/OLE DB Adapter Driver] ParseDisplayName failed"
Este error ocurre cuando usted intenta conectarse a un data source que usa un proveedor de datos diferente al especificado en el perfil de la base de datos.

Preguntas Frecuentes

P: ¿Debo instalar los componentes de acceso a datos de Microsoft (MDAC) aún si uso los proveedores Intersolv?
R: Si. Usted debe instalar MDAC ya que adicionalmente a instalar los proveedores, instala los componentes OLE DB que son necesarios para usar OLE DB con PowerBuilder.