Primeros pasos con el controlador ODBC de SIMBA Couchbase

Primeros pasos con el SIMBA Couchbase Controlador ODBC

ODBC ha existido desde principios de los 90 como una API estándar para acceder a varias fuentes de datos, tradicionalmente contra fuentes de datos estructurados como bases de datos relacionales. SIMBA Technologies ha lanzado recientemente un driver ODBC para Couchbase; esto ha abierto Couchbase a un gran número de herramientas de integración de datos y reporting de terceros. Esta es una guía de inicio rápido sobre cómo configurar el acceso ODBC para Couchbase en una estación de trabajo Windows con el SIMBA ODBC Driver para Couchbase.

Instalación de los controladores ODBC de SIMBA

Requisitos de software para esta Guía

Sistema operativo Windows (Windows 7 o superior)

Controlador SIMBA Couchbase ODBC 1.0.0.1000

Couchbase 4.x

Instale los cubos de muestras de Couchbase (beer-sample y travel-sample)

La instalación de los controladores SIMBA es sencilla: descargue los archivos de instalación del sitio web de SIMBA Technologies y ejecute la utilidad de instalación compatible (32 o 64 bits) con la aplicación que esté ejecutando.   

odbc1a

Tras la instalación, deberá copiar el archivo de licencia suministrado por SIMBA en el directorio /lib.  

odbc2a

Configuración del acceso ODBC a Couchbase

El instalador configura un DSN de sistema de ejemplo llamado "Simba Couchbase ODBC DSN". Puede revisar esta configuración con la utilidad ODBC Data Source Administrator que es una utilidad del Panel de Control de Windows.  

 odbc3
El DSN define la información de conectividad a un nodo Couchbase que ejecuta el servicio de consulta Couchbase. Consulte el archivo Documentación SIMBA para más detalles sobre cómo configurar el controlador. Los siguientes parámetros deben ser configurados para poner las cosas en marcha rápidamente:

odbc4

  1. Descripción: (Opcional)

  2. Servidor: Especifique el nombre de host o la dirección IP de un nodo Couchbase que ejecute el servicio de consulta Couchbase 4.x. En este ejemplo, el controlador apunta a un nodo local de Couchbase que se ejecuta en Windows 7.

  3. Puerto: Número de puerto para el servicio de consulta de Couchbase 4.x (por defecto es 8093.)

  4. Opciones avanzadas: Esto se cubre más adelante en este blog.  

  5. Definición del esquema: Esto se trata más adelante en el blog.

En el entorno de prueba, compruebe que muestra de cerveza y muestra de viaje están cargados. Confirme esto en la Consola de Administración de Couchbase | pestaña Data Buckets. Si los buckets no están cargados, consulte la sección Sitio de documentación de Couchbase para obtener instrucciones sobre cómo hacerlo.  

odbc5a

Definición rápida del esquema

Un esquema sirve como capa de traducción entre los datos de Couchbase y un formato compatible con ODBC. Un esquema puede almacenarse en un archivo JSON físico ubicado en tu entorno local de Windows o en cada bucket de Couchbase en el clúster de Couchbase. Esta sección te guiará a través de la inserción de un esquema en un clúster de Couchbase.

Paso 1 - Crear índices primarios en Couchbase Buckets

Si aún no lo has hecho, necesitas un índice primario en los documentos para que el driver ODBC de SIMBA Couchbase reconozca los distintos documentos y sus atributos almacenados en un bucket. Tendrá que utilizar la función Utilidad de línea de comandos CBQ situado en el directorio bin. En este ejemplo, se crea un índice primario para los buckets muestra-cerveza y muestra-viaje.  

odbc6

Paso 2 - Revisar las opciones avanzadas

En el panel DSN del controlador ODBC de Couchbase, haga clic en Opciones avanzadas. Hay que tener en cuenta los siguientes ajustes:

odbc7
  1. Modo de consulta - SQL (por defecto), emite una consulta SQL, las consultas fallidas se enviarán como N1QL.

  2. Longitud de columna de cadena - 1024 (por defecto), especifica la longitud de columna para los atributos de cadena.

  3. Ubicación del esquema activo - Base de datos (por defecto), Base de datos o archivo de esquema JSON local utilizado por el controlador.

  4. Tamaño de la muestra - 100 (por defecto), especifique el número de documentos que el controlador escanea para generar metadatos de esquema.

  5. Lista de nombres de tipos - Permite al desarrollador especificar tipos de documentos. El DSN por defecto creado por el instalador está configurado para trabajar con los tres cubos de muestra: travel-sample, beer-sample y gamesim-sample.  

Para los propósitos de esta guía, se recomienda permanecer con la configuración por defecto en el panel avanzado.  

Paso 3 - Generar un esquema y publicarlo en la base de datos

Para configurar el ODBC para los buckets de muestra, siga los siguientes pasos:

imports
  1. Haga clic en Examinar y apunte el controlador a un archivo json vacío en su sistema local. En este ejemplo, se especificó un archivo vacío llamado NewCB.json, ubicado en c:odbc.  

  2. Haga clic en Generar esquema, esto puede tardar un poco. Los metadatos del esquema se escribirán en el archivo especificado en el paso anterior. Aparecerá un diálogo de éxito.

  3. Haga clic en Editar archivo de esquema para verificar el contenido del archivo de esquema generado:

     odbc9

  4. Si quieres almacenar el esquema en la base de datos. Haz clic en Import Schema para escribir el esquema en cada bucket de Couchbase - obtendrás un cuadro de diálogo de éxito. Esto tomará el contenido del archivo JSON especificado en el paso 2 y lo exportará a cada bucket en el cluster Couchbase. Ya has subido el archivo de esquema a Couchbase.  

Conclusión:

Con el lanzamiento de los drivers SIMBA Couchbase ODBC para Couchbase, los desarrolladores tienen ahora acceso a una amplia gama de herramientas compatibles con ODBC para usos como la integración de datos, la generación de informes y la inteligencia empresarial. Esperamos que esta guía te ayude a configurar el driver ODBC de SIMBA para tu propio entorno de forma rápida y eficiente. Con el reciente lanzamiento de Couchbase 4.1, los desarrolladores ya pueden realizar operaciones DML en Couchbase a través de ODBC. blog invitado de Mike Howard, de Simba Technologies.

Comparte este artículo
Recibe actualizaciones del blog de Couchbase en tu bandeja de entrada
Este campo es obligatorio.

Autor

Publicado por Tim Wong

Tim es Consultor Principal de Soluciones en Couchbase, dando soporte a cuentas en el área de la Bahía de San Francisco. Ha trabajado con bases de datos, integración de datos empresariales (por lotes, en tiempo real, en la nube) y tecnologías de inteligencia empresarial durante más de 20 años en Oracle, TIBCO e Informatica.

2 Comentarios

  1. No estoy seguro de que esta instrucción sigue siendo válida para el último controlador de SIMA?

    [Simba][Couchbase] (130) No se puede conectar con el servidor Couchbase.
    El ODBC genérico requiere una configuración adicional. El controlador y el DSN (nombre de la fuente de datos) deben instalarse y configurarse para que coincidan con la conexión.
    No se puede conectar usando el DSN llamado "Sample Simba Couchbase ODBC DSN". Compruebe que el DSN existe y es una conexión válida.

    y de crear esquemas :

    Se ha producido un error al tomar muestras

    Driver={Controlador ODBC Simba Couchbase};AllowHostNameCNMismatch={0};AllowSelfSignedServerCert={0};AuthMech={0};CheckCertRevocation={0};CredFile={};Description={Sample Simba Couchbase ODBC DSN};Driver={Controlador ODBC Simba Couchbase};IsTest={0};LocalSchemaFile={};LogFileCount={50};LogFileSize={20};Port={8093};QueryMode={0};Redundancy={0};SampleSize={100};ScanConsistency={0};Schema={default};SchemaMapOperation={0};Server={35. 243.80.58};Simba Couchbase ODBC DSN};CredFile={0};Description={Muestra de Couchbase ODBC DSN};Driver={Simba Couchbase ODBC DSN};Driver={0}.243.80.58};SimulateTransactions={0};SSL={0};StringColumnLength={255};TrustedCerts={C:\Program Files (x86)\Simba Couchbase ODBC Driver\lib\cacerts.pem};TypeNameList={muestra de cerveza:tipo,viaje-muestra:tipo,gamesim-muestra:jsonType};UseSystemTrustStore={0}

  2. Tim Wong, Consultor de soluciones, Couchbase noviembre 28, 2018 a 10:53 am

    @wirasakc - No he probado con los últimos controladores SIMBA, esto fue probado en una versión que fue lanzado hace más de tres años.

    Yo te remitiría a los docs de SIMBA - su última versión salió a principios de 2018.
    https://www.simba.com/products/Couchbase/doc/ODBC_InstallGuide/win/content/odbc/intro.htm

    Por otra parte, un colega acaba de escribir un blog sobre el uso del controlador ODBC de CDATA que es totalmente nuevo. https://www.couchbase.com/connecting-to-couchbase-via-odbc/

    Yo echaría un vistazo a este blog y probaría los controladores ODBC de CDATA -

    https://www.couchbase.com/connecting-to-couchbase-via-odbc/

Deja un comentario

¿Listo para empezar con Couchbase Capella?

Empezar a construir

Consulte nuestro portal para desarrolladores para explorar NoSQL, buscar recursos y empezar con tutoriales.

Utilizar Capella gratis

Ponte manos a la obra con Couchbase en unos pocos clics. Capella DBaaS es la forma más fácil y rápida de empezar.

Póngase en contacto

¿Quieres saber más sobre las ofertas de Couchbase? Permítanos ayudarle.