Conexión a Couchbase

Couchbase es una base de datos orientada a los documentos NoSQL. Utilice el conector de datos de Couchbase para importar los datos de Couchbase de su organización.

Antes de comenzar

Para conectarse a Couchbase, debe contar con lo siguiente:

• al menos un nodo de su instancia de Couchbase con los servicios de índice y consulta habilitados
• el nombre de host del servidor de la base de datos
• el puerto de conexión correcto
• las credenciales adecuadas para el método de autenticación que escoja

  Si su instancia de Couchbase requiere autenticación, debe proporcionar una cadena JSON o un archivo JSON que especifique el nombre y la contraseña para uno o más contenedores. Si desea obtener más información, consulte Formato de autenticación de JSON.

• un certificado SSL válido si la conexión se realizará a través de SSL

Si desea obtener ayuda para reunir los requisitos previos para la conexión, comuníquese con el administrador de Couchbase de su organización. Si el administrador no puede ayudarlo, usted o el administrador deben comunicarse con el Soporte de Couchbase.

Crear una conexión a Couchbase

1. Desde el menú principal de Analytics, seleccione Importar > Base de datos y aplicación.Analytics
2. Desde la ficha Nuevas conexiones, en la sección Conectores ACL, seleccione Couchbase.

   Consejo

   Puede filtrar la lista de conectores disponibles introduciendo una cadena de búsqueda en el cuadro Filtrar conexiones. Los conectores se indican en orden alfabético.

3. En el panel Ajustes de conexión de datos, ingrese la configuración de la conexión y, en la parte inferior del panel, haga clic en Guardar y conectar.

   Puede aceptar el Nombre de la conexión predeterminado o introducir uno nuevo.

La conexión de Couchbase se guarda en la ficha Conexiones existentes. En el futuro, puede volver a conectarse a Couchbase desde la conexión guardada.

Una vez que se establezca la conexión, se abre la ventana Acceso a Datos en el Área de almacenamiento temporal y puede comenzar a importar datos. Si desea obtener ayuda para importar datos desde Couchbase, consulte Trabajo con la ventana Acceso a Datos.

Ajustes de conexión

Ajustes avanzados

Consulta de la instancia de Couchbase

Formato de autenticación de JSON

[{"usuario" : "nombredeusuario1", "contraseña" : "contraseña1"},
{"usuario" : "nombredeusuario2", "contraseña" : "contraseña2"}]

Comparación entre consultas de SQL y llamadas de API en N1QL

El conector utiliza consultas SQL normales en el Servidor de Couchbase y traduce las consultas SQL-92 estándar en llamadas de API al cliente N1QL equivalentes. Esta traducción permite realizar consultas estándar en su instancia del Servidor de Couchbase Server. Si no es posible traducir una consulta totalmente, las partes traducidas de la consulta se envían como una o más consultas de N1QL a la instancia del Servidor de Couchbase Server para el procesamiento mientras que las partes no traducidas de la consulta son procesadas por el Conector.

Definición del esquema

Couchbase puede almacenar datos que siguen diferentes reglas de estructura y escritura en comparación con las columnas y las tablas relacionales tradicionales. Los datos de Couchbase se organizan en contenedores y documentos, que pueden contener matrices o matrices anidadas de elementos escritos de manera diferente. Estos datos se deben asignar a una forma relacional. Para lograrlo, el conector genera una definición de esquema que asigna los datos de Couchbase a un formato compatible con ODBC.

Al conectarse a una base de datos que todavía no tiene la definición de esquema necesaria, el conector genera una automáticamente haciendo lo siguiente:

1. Para cada tipo de documento que se identifica en la base de datos, el conector toma muestras de datos de varios documentos a fin de detectar la estructura de los datos.
2. El conector organiza todos los documentos en colecciones según el tipo y guarda estas colecciones como parte de la definición de esquema. Con la definición de esquema, el controlador muestra las colecciones como tablas.
3. Para cada matriz que se detecta en la base de datos, el conector genera una tabla virtual a fin de expandir los datos y guarda estas tablas virtuales como parte del esquema. Con el esquema, el controlador muestra las tablas virtuales como tablas normales.
4. El conector define un tipo de datos de Couchbase para cada columna y asigna cada tipo de datos de Couchbase al tipo de datos de SQL que mejor representa la mayor cantidad de valores.

Tabla base

Las tablas base representan datos de las colecciones de documentos de Couchbase. Los documentos aparecen como filas y todos los atributos que no son matrices aparecen como columnas. En cada tabla base, el conector crea una columna de clave primaria denominada PK que identifica de qué documento de Couchbase proviene cada fila.

En el conector, el nombre de la tabla base es el tipo de documento al cual representa. En Couchbase, el nombre de la tabla base es el contenedor del cual provienen los datos.

Tablas virtuales

Las tablas virtuales ofrecen soporte para las matrices. Cada tabla virtual contiene datos de una matriz y cada fila de la tabla representa un elemento de la matriz. Si un elemento contiene una matriz, el conector crea tablas virtuales adicionales según sea necesario para expandir los datos anidados.

En cada tabla virtual, el conector crea un nombre de columna clave que identifica el documento de donde proviene la matriz y hace referencia a la columna de la tabla base relacionada. El conector también crea una columna de índice (con el sufijo _IDX en el nombre) para indicar la posición del elemento dentro de la matriz.

{
  "Tipo": "Cliente",
  "Nombre": "Pedro Pérez",
  "DomiciliosGuardados": ["123 Main St.", "456 1st Ave"]
}

{
  "Tipo": "Orden",
  "IDCliente":"Cliente_123221",
  "TarjetaCrédito":
    {
      "Tipo":"Visa",
       "NúmeroTarjeta":"4111 1111 1111 1111",
       "Vencimiento":"12/12",
       "CVN":"123"
    },
  "Items":
    [
      {"IDItem":89123, "Cantidad":1},
      {"IDItem":92312, "Cantidad":5}
    ]
}