Detalles de Conexión de Apache Cassandra¶

Introducción¶

Versión del conector

Esta documentación se basa en la versión 21.0.8257 del conector.

Empezando¶

Compatibilidad con la versión de Cassandra

El conector es compatible con las versiones 2.0, 3.0 y 4.0 de CQL

Establecer una Conexión¶

Conectando al Servidor¶

Selecciona el Server y Database propiedades de conexión para conectarse a Cassandra.

Para conectarse a un sistema distribuido, puede configurar Server a una lista de servidores y puertos separados por comas, separados por dos puntos. También deberá configurar ConsistencyLevel.

Las siguientes secciones detallan las propiedades de conexión para autenticación, seguridad y acceso a datos. Consulte Ajuste preciso del acceso a datos si necesita más control sobre la conexión a su sistema.

Conexión a CosmosDB con la API de Cassandra¶

Para obtener la cadena de conexión necesaria para conectarse a una cuenta de Cosmos DB mediante Cassandra API, inicie sesión en Azure Portal, seleccione Azure Cosmos DB y seleccione su cuenta. En la sección Configuración, haga clic en Cadena de conexión y establezca los siguientes valores.

• Server: establezca esto en el valor de Host, el FQDN del servidor aprovisionado para su cuenta. También puede especificar el puerto aquí o en Port.
• Port: Establézcalo en el puerto.
• Database: establezca esto en la base de datos desde la que desea leer y escribir.
• User: el nombre de la cuenta de Cosmos DB.
• Password: la clave de cuenta asociada con la cuenta de Cosmos DB.
• UseSSL: Establecer en Verdadero

Asegurar las Conexiones de Cassandra¶

Puede establecer UseSSL para negociar el cifrado SSL/TLS cuando se conecta. De forma predeterminada, el conector intenta negociar SSL/TLS comparando el certificado del servidor con el almacén de certificados de confianza del sistema. Para especificar otro certificado, consulte SSLServerCert propiedad de los formatos disponibles para hacerlo.

Autenticando a Cassandra¶

El conector admite la autenticación básica con credenciales de inicio de sesión y las funciones de autenticación adicionales de DataStax Enterprise (DSE) Cassandra. Las siguientes secciones detallan las propiedades de conexión que puede requerir su método de autenticación.

Necesita configurar AuthScheme al valor correspondiente al autenticador configurado para su sistema. Usted especifica el autenticador en el authenticator propiedad en el archivo cassandra.yaml. Este archivo normalmente se encuentra en /etc/dse/cassandra. o a través del DSE Unified Authenticator en DSE Cassandra.

Autenticación Básica¶

La autenticación básica es compatible con el PasswordAuthenticator predeterminado incorporado de Cassandra.

• Selecciona el AuthScheme propiedad a 'BÁSICO' y establezca User y Password propiedades.
• En el archivo cassandra.yaml, establezca el authenticator propiedad a 'PasswordAuthenticator'.

Autenticación Kerberos¶

La autenticación Kerberos es compatible con la autenticación unificada de DataStax Enterprise.

• Selecciona el AuthScheme propiedad a 'KERBEROS' y establezca User y Password propiedades.
• Selecciona el KerberosKDC, KerberosRealm, y KerberosSPN propiedades.
• En el archivo cassandra.yaml, establezca el authenticator propiedad a "com.datastax.bdp.cassandra.auth.DseAuthenticator".
• Modificar el authentication_options sección en el archivo dse.yaml, especificando las propiedades default_schema y other_schemas como 'kerberos'.
• Modificar el kerberos_options sección en el archivo dse.yaml, especificando las propiedades keytab, service_principle, http_principle y qop

Consulte Uso de Kerberos para obtener más detalles sobre cómo configurar las propiedades de conexión para conectarse a Kerberos.

Autenticación LDAP¶

La autenticación LDAP es compatible con la autenticación unificada de DataStax Enterprise.

• Selecciona el AuthScheme propiedad a ' LDAP' y establezca User y Password propiedades.
• En el archivo cassandra.yaml, establezca el authenticator propiedad a "com.datastax.bdp.cassandra.auth.DseAuthenticator".
• Modificar el authentication_options sección en el archivo dse.yaml, especificando las propiedades default_schema y other_schemas como 'ldap'.
• Modificar el ldap_options en el archivo dse.yaml, especificando las propiedades server_host, server_port, search_dn, search_password, user_search_base y user_search_filter

Uso de PKI¶

Puede especificar un certificado de cliente para autenticar el conector con SSLClientCert, SSLClientCertType, SSLClientCertSubject, y SSLClientCertPassword.

Uso de Kerberos¶

Esta sección muestra cómo usar el conector para autenticarse en Cassandra usando Kerberos.

Autenticación con Kerberos¶

Para autenticarse en Cassandra mediante Kerberos, establezca las siguientes propiedades:

• AuthScheme: Establézcalo en KERBEROS.
• KerberosKDC: Establézcalo en host name or IP Address de su máquina Kerberos KDC.
• KerberosRealm: Establézcalo en the realm of the Cassandra Kerberos principal. Este será el valor después del símbolo '@' (por ejemplo, EXAMPLE.COM) de principal value (por ejemplo, hbase/MyHost@EXAMPLE.COM).
• KerberosSPN: Establézcalo en service and host of the Cassandra Kerberos Principal. Este será el valor anterior al símbolo '@' (por ejemplo, hbase/MyHost) de principal value (por ejemplo, hbase/MyHost@EXAMPLE.COM).

Recuperar el Ticket de Kerberos¶

Puede utilizar una de las siguientes opciones para recuperar el vale de Kerberos necesario.

Archivo de Caché de Credenciales MIT Kerberos¶

Esta opción le permite utilizar el administrador de tickets MIT Kerberos o el comando kinit para obtener tickets. Tenga en cuenta que usted no necesitará configurar el User o Password propiedades de conexión con esta opción.

1. Asegúrese de tener una variable de ambiente creada llamada KRB5CCNAME.
2. Configure el KRB5CCNAME variable de ambiente a una ruta que apunta a su credential cache file (por ejemplo, C:\krb_cache\krb5cc_0 o /tmp/krb5cc_0). Este archivo se creará al generar su ticket con MIT Kerberos Ticket Manager.
3. Para obtener un ticket, abra la aplicación MIT Kerberos Ticket Manager, haga clic en Get Ticket, enter your principal name and password, then click OK. Si tiene éxito, la información del ticket aparecerá en Kerberos Ticket Manager y ahora se almacenará en el archivo de caché de credenciales.
4. Ahora que se ha creado el archivo de caché de credenciales, el conector utilizará el archivo de caché para obtener el vale de Kerberos para conectarse a Cassandra.

Como alternativa a la configuración de KRB5CCNAME variable de ambiente, puede establecer directamente la ruta del archivo usando KerberosTicketCache propiedad. Cuando se establece, el conector utilizará el archivo de caché especificado para obtener el vale de Kerberos para conectarse a Cassandra.

Archivo de Tabla de Claves¶

Si no se ha configurado la variable de entorno KRB5CCNAME, puede recuperar un ticket de Kerberos usando un Keytab File. Para hacer esto, configure User propiedad al nombre de usuario deseado y configure KerberosKeytabFile propiedad a una ruta de archivo que apunta al archivo keytab asociado con el usuario.

Usuario y Contraseña¶

Si no se han establecido ni la variable de entorno KRB5CCNAME ni la propiedad KerberosKeytabFile, puede recuperar un boleto usando un User and Password combination. Para hacer esto, configure User y Password propiedades al combo de usuario/contraseña que usa para autenticarse con Cassandra.

Autenticación Entre Reinos¶

Los ambientes de Kerberos más complejos pueden requerir la autenticación entre dominios donde se utilizan múltiples dominios y servidores KDC (por ejemplo, donde se usa un dominio/KDC para la autenticación del usuario y otro dominio/KDC para obtener el ticket de servicio).

En tal ambiente, el KerberosRealm y KerberosKDC las propiedades se pueden establecer en los valores necesarios para la autenticación del usuario. El KerberosServiceRealm y KerberosServiceKDC las propiedades se pueden configurar a los valores requeridos para obtener el ticket de servicio.

Ajuste Fino del Acceso a los Datos¶

Ajuste Fino del Acceso a Datos¶

Puede usar las siguientes propiedades para obtener un mayor control sobre las características de la API de Cassandra y las estrategias que usa el conector para mostrarlas:

• AllowFiltering: establezca esta propiedad para permitir que el servidor procese búsquedas de rendimiento lento.

• UseJsonFormat: Establezca esta propiedad para usar literales CQL en lugar de JSON.

• QueryPassthrough: esta propiedad le permite utilizar sentencias CQL nativas en lugar de SQL.

• RowScanDepth: esta propiedad determina la cantidad de filas que se escanearán para detectar tipos de datos de columna al generar metadatos de tabla.

  Esta propiedad se aplica si está trabajando con los esquemas dinámicos generados a partir de Automatic Schema Discovery o si está utilizando QueryPassthrough.

Notas Importantes¶

Procedimientos Almacenados¶

• Las funciones de procedimientos almacenados descritas en esta documentación no se admiten actualmente.
• Debido a que los procedimientos almacenados no se admiten actualmente, cualquier característica que dependa de los procedimientos almacenados tampoco se admite actualmente.

Archivos de Configuración y Sus Rutas¶

• Todas las referencias a la adición de archivos de configuración y sus rutas se refieren a archivos y ubicaciones en Harmony Agente donde está instalado el conector. Estas rutas deben ajustarse según corresponda según el agente y el sistema operativo. Si se utilizan varios agentes en un grupo de agentes, se requerirán archivos idénticos en cada agente.

Base de Datos NoSQL¶

Cassandra es una base de datos NoSQL que proporciona alto rendimiento, disponibilidad y escalabilidad. Sin embargo, estas capacidades no son necesariamente incompatibles con un lenguaje de consultar compatible con estándares como SQL-92. El conector modela las tablas de Cassandra en tablas relacionales y traduce las consultas SQL en llamadas a Cassandra API, el protocolo binario CQL (Cassandra Query Language).

El equivalente de una tabla en Cassandra es una familia de columnas. Las familias de columnas contienen columnas de datos relacionados. Al igual que otras bases de datos NoSQL, Cassandra permite tipos complejos de campos como conjunto, lista y mapa. Una familia de columnas es una estructura de datos de mapas anidados. Esto se puede representar como un objeto JSON.

El conector ofrece dos formas de modelar objetos Cassandra. El Descubrimiento automático de esquemas encuentra automáticamente los tipos de datos en un objeto Cassandra escaneando un número configurado de filas del objeto. Puedes usar RowScanDepth, FlattenArrays, y FlattenObjects para controlar la representación relacional de las tablas en Cassandra.

Descubrimiento Automático de Esquemas¶

El conector infiere automáticamente un esquema relacional al inspeccionar una serie de documentos de Cassandra en una colección. Puedes usar el RowScanDepth propiedad para definir el número de documentos que escaneará el conector para hacerlo. Las columnas identificadas durante el proceso de descubrimiento dependen de FlattenArrays y FlattenObjects propiedades.

Aplanar Objetos¶

Si FlattenObjects está configurado, todos los objetos anidados se aplanarán en una serie de columnas. Por ejemplo, considere el siguiente documento:

{
  id: 12,
  name: "Lohia Manufacturers Inc.",
  address: {street: "Main Street", city: "Chapel Hill", state: "NC"},
  offices: ["Chapel Hill", "London", "New York"],
  annual_revenue: 35,600,000
}

Este documento estará representado por las siguientes columnas:

Si FlattenObjects no está configurado, las columnas dirección.calle, dirección.ciudad y dirección.estado no se dividirán. En cambio, la columna de dirección de tipo cadena representará el objeto completo. su valor seria {street: "Main Street", city: "Chapel Hill", state: "NC"}. Vea Funciones JSON para obtener más detalles sobre cómo trabajar con agregados JSON.

Aplanamiento de Matrices¶

El FlattenArrays La propiedad se puede usar para aplanar valores de matriz en columnas propias. Esto solo se recomienda para matrices que se espera que sean cortas, por ejemplo, las siguientes coordenadas:

"coord": [-73.856077, 40.848447 ]

El FlattenArrays la propiedad se puede establecer en 2 para representar la matriz anterior de la siguiente manera:

Es mejor dejar otras matrices ilimitadas como están y dividir los datos según sea necesario usando Funciones JSON.

Funciones JSON¶

El conector puede devolver estructuras JSON como valores de columna. El conector le permite utilizar funciones SQL estándar para trabajar con estas estructuras JSON. Los ejemplos de esta sección utilizan la siguiente matriz:

[
     { "grade": "A", "score": 2 },
     { "grade": "A", "score": 6 },
     { "grade": "A", "score": 10 },
     { "grade": "A", "score": 9 },
     { "grade": "B", "score": 14 }
]

JSON_EXTRACT¶

La función JSON_EXTRACT puede extraer valores individuales de un objeto JSON. La siguiente consultar devuelve los valores que se muestran a continuación en función de la ruta JSON pasada como segundo argumento de la función:

SELECT Name, JSON_EXTRACT(grades,'[0].grade') AS Grade, JSON_EXTRACT(grades,'[0].score') AS Score FROM Students;

JSON_COUNT¶

La función JSON_COUNT devuelve la cantidad de elementos en una matriz JSON dentro de un objeto JSON. La siguiente consultar devuelve la cantidad de elementos especificados por la ruta JSON pasada como segundo argumento a la función:

SELECT Name, JSON_COUNT(grades,'[x]') AS NumberOfGrades FROM Students;

JSON_SUM¶

La función JSON_SUM devuelve la suma de los valores numéricos de una matriz JSON dentro de un objeto JSON. La siguiente consultar devuelve el total de los valores especificados por la ruta JSON pasada como segundo argumento a la función:

SELECT Name, JSON_SUM(score,'[x].score') AS TotalScore FROM Students;

JSON_MIN¶

La función JSON_MIN devuelve el valor numérico más bajo de una matriz JSON dentro de un objeto JSON. La siguiente consultar devuelve el valor mínimo especificado por la ruta JSON pasada como segundo argumento a la función:

SELECT Name, JSON_MIN(score,'[x].score') AS LowestScore FROM Students;

JSON_MAX¶

La función JSON_MAX devuelve el valor numérico más alto de una matriz JSON dentro de un objeto JSON. La siguiente consultar devuelve el valor máximo especificado por la ruta JSON pasada como segundo argumento a la función:

SELECT Name, JSON_MAX(score,'[x].score') AS HighestScore FROM Students;

JSON¶

La función JSON se puede usar para recuperar la tabla completa como una cadena JSON. Vea la siguiente consultar y su resultado como un ejemplo:

SELECT JSON(*) FROM Customers;

La consultar anterior devolverá la tabla completa como se muestra.

{ "id": 12, "name": "Lohia Manufacturers Inc.", "address": { "street": "Main Street", "city": "Chapel Hill", "state": "NC"}, "offices": ["Chapel Hill", "Londres", "Nueva York" ], "annual_revenue": 35,600,000 }

Asignación de Tipos de Datos¶

Asignaciones de Tipos de Datos¶

El conector asigna tipos del origen de datos al tipo de datos correspondiente disponible en el esquema. La siguiente tabla documenta estas asignaciones.

Tenga en cuenta que las columnas de cadena pueden asignarse a diferentes tipos de datos según su longitud.

Tablas del Sistema¶

Puede consultar las tablas del sistema que se describen en esta sección para acceder a la información del esquema, la información sobre la funcionalidad del origen de datos y las estadísticas de operación lote.

Tablas de Esquema¶

Las siguientes tablas devuelven metadatos de la base de datos para Cassandra:

• sys_catalogs: enumera las bases de datos disponibles.
• sys_schemas: enumera los esquemas disponibles.
• sys_tablas: enumera las tablas y vistas disponibles.
• sys_tablecolumns: Describe las columnas de las tablas y vistas disponibles.
• procedimientos_sys: describe los procedimientos almacenados disponibles.
• parámetros_procedimiento_sys: Describe procedimiento almacenado* parámetros.
• sys_keycolumns: describe las claves principal y externa.
• índices_sys: Describe los índices disponibles.

Tablas de Fuentes de Datos¶

Las siguientes tablas devuelven información sobre cómo conectarse y consultar la fuente de datos:

• sys_connection_props: Devuelve información sobre las propiedades de conexión disponibles.
• sys_sqlinfo: describe las consultas SELECT que el conector puede descargar al origen de datos.

Tablas de Información de Consultas¶

La siguiente tabla devuelve estadísticas de consultar para consultas de modificación de datos, incluidas las operaciones lote:

• identidad_sys: devuelve información sobre operaciones lote o actualizaciones individuales.

Sys_catalogs¶

Enumera las bases de datos disponibles.

La siguiente consultar recupera todas las bases de datos determinadas por la cadena de conexión:

SELECT * FROM sys_catalogs

Columnas¶

Sys_schemas¶

Enumera los esquemas disponibles.

La siguiente consultar recupera todos los esquemas disponibles:

SELECT * FROM sys_schemas

Columnas¶

Sys_tables¶

Enumera las tablas disponibles.

La siguiente consultar recupera las tablas y vistas disponibles:

SELECT * FROM sys_tables

Columnas¶

Sys_tablecolumns¶

Describe las columnas de las tablas y vistas disponibles.

La siguiente consultar devuelve las columnas y los tipos de datos para la tabla ""."Sample".Products:

SELECT ColumnName, DataTypeName FROM sys_tablecolumns WHERE TableName='Products' AND CatalogName='' AND SchemaName='Sample'

Columnas¶

Sys_procedimientos¶

Enumera los procedimientos almacenados disponibles.

La siguiente consultar recupera los procedimientos almacenados disponibles:

SELECT * FROM sys_procedures

Columnas¶

Sys_procedureparameters¶

Describe procedimiento almacenado* parámetros.

La siguiente consultar devuelve información sobre todos los parámetros de entrada para el procedimiento almacenado SelectEntries:

SELECT * FROM sys_procedureparameters WHERE ProcedureName='SelectEntries' AND Direction=1 OR Direction=2

Columnas¶

Sys_keycolumns¶

Describe las claves primarias y foráneas. La siguiente consultar recupera la clave principal para la tabla ""."Sample".Products:

SELECT * FROM sys_keycolumns WHERE IsKey='True' AND TableName='Products' AND CatalogName='' AND SchemaName='Sample'

Columnas¶

Sys_foreignkeys¶

Describe las claves foráneas. La siguiente consultar recupera todas las claves foráneas que hacen referencia a otras tablas:

SELECT * FROM sys_foreignkeys WHERE ForeignKeyType = 'FOREIGNKEY_TYPE_IMPORT'

Columnas¶

Sys_indexes¶

Describe los índices disponibles. Al filtrar en los índices, puede escribir consultas más selectivas con tiempos de respuesta de consultar más rápidos.

La siguiente consultar recupera todos los índices que no son claves principales:

SELECT * FROM sys_indexes WHERE IsPrimary='false'

Columnas¶

Sys_connection_props¶

Devuelve información sobre las propiedades de conexión disponibles y las establecidas en la cadena de conexión.

Al consultar esta tabla, se debe usar la cadena de conexión de configuración:

jdbc:cdata:cassandra:config:

Esta cadena de conexión le permite consultar esta tabla sin una conexión válida.

La siguiente consultar recupera todas las propiedades de conexión que se han establecido en la cadena de conexión o se han establecido a través de un valor predeterminado:

SELECT * FROM sys_connection_props WHERE Value <> ''

Columnas¶

Sys_sqlinfo¶

Describe el procesamiento de consultar SELECT que el conector puede descargar al origen de datos.

Procesamiento Colaborativo de Consultas¶

Al trabajar con fuentes de datos que no admiten SQL-92, puede consultar la vista sys_sqlinfo para determinar las capacidades de consultar de las APIs subyacentes, expresadas en sintaxis SQL. El conector descarga la mayor cantidad posible del procesamiento de sentencias SELECT al servidor y luego procesa el resto de la consultar en la memoria.

Descubrimiento de las Capacidades SELECT de la Fuente de Datos¶

A continuación se muestra un conjunto de datos de ejemplo de las capacidades de SQL. El siguiente conjunto de resultados indica la funcionalidad SELECT que el conector puede descargar en el origen de datos o en el lado del cliente del proceso. Su fuente de datos puede admitir sintaxis SQL adicional. Algunos aspectos de la funcionalidad SELECT se devuelven en una lista separada por comas si es compatible; de lo contrario, la columna contiene NO.

La siguiente consultar recupera los operadores que se pueden usar en la cláusula WHERE:

SELECT * FROM sys_sqlinfo WHERE Name='SUPPORTED_OPERATORS'

Tenga en cuenta que las tablas individuales pueden tener diferentes limitaciones o requisitos en la cláusula WHERE; consulte la Base de datos NoSQL para obtener más información.

Columnas¶

Sys_identidad¶

Devuelve información sobre los intentos de modificación.

La siguiente consultar recupera los Id. de las filas modificadas en una operación lote:

SELECT * FROM sys_identity

Columnas¶

Características Avanzadas¶

Esta sección detalla una selección de funciones avanzadas del conector Cassandra.

Vistas definidas por el usuario

El conector le permite definir tablas virtuales, llamadas vistas definidas por el usuario, cuyo contenido se decide mediante una consultar preconfigurada. Estas vistas son útiles cuando no puede controlar directamente las consultas que se envían a los controladores. Consulte Vistas definidas por el usuario para obtener una descripción general de la creación y configuración de vistas personalizadas.

Configuración SSL

Usar Configuración SSL para ajustar cómo el conector maneja las negociaciones de certificados TLS/SSL. Puede elegir entre varios formatos de certificado; ver el SSLServerCert propiedad en "Opciones de cadena de conexión" para obtener más información.

Firewall y Proxy

Configure el conector para cumplir con Firewall y Proxy, incluidos los proxies de Windows. También puede configurar conexiones de túnel.

Vistas Definidas por el Usuario¶

El conector Jitterbit para Cassandra le permite definir una tabla virtual cuyos contenidos se deciden mediante una consultar preconfigurada. Estas se denominan Vistas definidas por el usuario, que son útiles en situaciones en las que no puede controlar directamente la consultar que se envía al controlador, por ejemplo, cuando se utiliza el controlador de Jitterbit. Las vistas definidas por el usuario se pueden utilizar para definir predicados que siempre se aplican. Si especifica predicados adicionales en la consultar a la vista, se combinan con la consultar ya definida como parte de la vista.

Hay dos formas de crear vistas definidas por el usuario:

• Cree un archivo de configuración con formato JSON que defina las vistas que desea.
• Declaraciones DDL.

Definición de Vistas Usando un Archivo de Configuración¶

Las vistas definidas por el usuario se definen en un archivo de configuración con formato JSON llamado UserDefinedViews.json. El conector detecta automáticamente las vistas especificadas en este archivo.

También puede tener múltiples definiciones de vista y controlarlas usando UserDefinedViews propiedad de conexión. Cuando utiliza esta propiedad, el conector solo ve las vistas especificadas.

Este archivo de configuración de vista definida por el usuario tiene el siguiente formato:

• Cada elemento raíz define el nombre de una vista.
• Cada elemento raíz contiene un elemento hijo, llamado query, que contiene la consultar SQL personalizada para la vista.

Por ejemplo:

{
    "MyView": {
        "query": "SELECT * FROM \"\".\"Sample\".Products WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

Utilizar el UserDefinedViews propiedad de conexión para especificar la ubicación de su archivo de configuración JSON. Por ejemplo:

"UserDefinedViews", "C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json"

Esquema para Vistas Definidas por el Usuario¶

Las vistas definidas por el usuario se exponen en UserViews esquema por defecto. Esto se hace para evitar que el nombre de la vista entre en conflicto con una entidad real en el modelo de datos. Puede cambiar el nombre del esquema utilizado para UserViews configurando UserViewsSchemaName propiedad.

Trabajar con Vistas Definidas por el Usuario¶

Por ejemplo, una instrucción SQL con una vista definida por el usuario llamada UserViews.RCustomers solo enumera clientes en Raleigh:

SELECT * FROM Customers WHERE City = 'Raleigh';

Un ejemplo de una consultar al controlador:

SELECT * FROM UserViews.RCustomers WHERE Status = 'Active';

Dando como resultado la consultar efectiva a la fuente:

SELECT * FROM Customers WHERE City = 'Raleigh' AND Status = 'Active';

Ese es un ejemplo muy simple de una consultar a una vista definida por el usuario que es efectivamente una combinación de la consultar de vista y la definición de vista. Es posible componer estas consultas en patrones mucho más complejos. Todas las operaciones de SQL están permitidas en ambas consultas y se combinan cuando corresponde.

Configuración SSL¶

Personalización de la Configuración SSL¶

De forma predeterminada, el conector intenta negociar SSL/TLS comparando el certificado del servidor con el almacén de certificados de confianza del sistema.

Para especificar otro certificado, consulte SSLServerCert propiedad de los formatos disponibles para hacerlo.

Certificados SSL de Cliente¶

El conector Cassandra también admite la configuración de certificados de cliente. Configure lo siguiente para conectarse mediante un certificado de cliente.

• SSLClientCert: el nombre del almacén de certificados para el certificado de cliente.
• SSLClientCertType: el tipo de almacén de claves que contiene el certificado de cliente TLS/SSL.
• SSLClientCertPassword: La contraseña para el certificado de cliente TLS/SSL.
• SSLClientCertSubject: El asunto del certificado de cliente TLS/SSL.

Propiedades de Configuraciones Avanzadas¶

Las propiedades de configuraciones avanzadas son las diversas opciones que se pueden utilizar para establecer una conexión. Esta sección proporciona una lista completa de las opciones que puede configurar. Haga clic en los enlaces para obtener más detalles.

Autenticación

Kerberos

SSL

SSH

Esquema

Misceláneas

Autenticación¶

Esta sección proporciona una lista completa de las propiedades de autenticación que puede configurar.

AuthScheme¶

El esquema utilizado para la autenticación. Las entradas aceptadas son Basic, DSE, Kerberos y LDAP.

Valores Posibles¶

Basic, DSE, Kerberos, LDAP

Tipo de Datos¶

string

Valor por Defecto¶

"Basic"

Observaciones¶

Establezca esta propiedad para autenticarse en instancias Cassandra de código abierto o DataStax Enterprise (DSE).

Junto con Contraseña y Usuario, este campo se utiliza para autenticarse en el servidor. Básico es la opción predeterminada. Utilice las siguientes opciones para seleccionar su esquema de autenticación:

• Básico: configure esto para autenticarse con credenciales de inicio de sesión y la autenticación integrada de Cassandra.
• DSE: configure esto para autenticarse con credenciales de inicio de sesión y el autenticador unificado de DSE.
• Kerberos: configure esto para usar Kerberos para autenticar.
• LDAP: configure esto para usar LDAP para autenticarse.

Consulte la sección Introducción para obtener guías sobre el uso de cada método de autenticación.

Servidor¶

El nombre de alojar o la dirección IP del servidor que aloja la base de datos de Cassandra.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

El nombre de alojar o la dirección IP del servidor que aloja la base de datos de Cassandra. Para conectarse a un sistema distribuido, puede configurar Server a una lista de servidores y puertos separados por comas, separados por dos puntos. También deberá establecer ConsistencyLevel.

Tenga en cuenta que debe especificar todos los servidores requeridos por su nivel de consistencia seleccionado.

Puerto¶

El puerto para la base de datos Cassandra.

Tipo de Datos¶

string

Valor por Defecto¶

"9042"

Observaciones¶

El puerto para la base de datos Cassandra.

Servidor LDAP¶

El nombre de alojar o la dirección IP del servidor LDAP.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

El nombre de alojar o la dirección IP del servidor LDAP.

Usuario¶

La cuenta de usuario de Cassandra utilizada para la autenticación.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Junto con Contraseña, este campo se usa para autenticarse en el servidor Cassandra.

Contraseña¶

La contraseña utilizada para autenticar al usuario.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

El usuario y Password se usan juntos para autenticarse con el servidor.

Puerto LDAP¶

El puerto para el servidor LDAP.

Tipo de Datos¶

string

Valor por Defecto¶

"389"

Observaciones¶

El puerto para el servidor LDAP.

Base de Datos¶

El nombre del espacio de claves de Cassandra.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

El nombre del espacio de claves de Cassandra que contiene las tablas.

Usuario LDAPU Predeterminado¶

El usuario LDAP predeterminado utilizado para conectarse y comunicarse con el servidor, debe establecerse si el servidor LDAP no permite el enlace anónimo.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Especifique el usuario LDAP predeterminado en caso de que el servidor LDAP no permita el inicio de sesión anónimo.

Contraseña LDAP¶

La contraseña del usuario LDAP predeterminado. Debe configurarse si el servidor LDAP no permite el enlace anónimo.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Especifique la contraseña del usuario LDAP predeterminado.

Base de Búsqueda¶

La base de búsqueda para su LDAPServer, utilizada para buscar usuarios.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

La base de búsqueda para su LDAPServer, utilizada para buscar usuarios.

Filtro de Búsqueda¶

El filtro de búsqueda para buscar nombres de usuario en LDAP. La configuración predeterminada es (uid=). Cuando utilice Active Directory, establezca el filtro en (sAMAccountName=).

Tipo de Datos¶

string

Valor por Defecto¶

"uid="

Observaciones¶

El filtro de búsqueda para buscar nombres de usuario en LDAP. La configuración predeterminada es (uid=).

Usar SSL¶

Este campo establece si SSL está habilitado.

Tipo de Datos¶

bool

Valor por Defecto¶

false

Observaciones¶

Este campo establece si el conector intentará negociar conexiones TLS/SSL con el servidor. De forma predeterminada, el conector compara el certificado del servidor con el almacén de certificados de confianza del sistema. Para especificar otro certificado, establezca SSLServerCert.

Kerberos¶

Esta sección proporciona una lista completa de las propiedades de Kerberos que puede configurar.

KerberosKDC¶

El servicio Kerberos Key Distribution Center (KDC) utilizado para autenticar al usuario.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Las propiedades de Kerberos se usan cuando se usa SPNEGO o la autenticación de Windows. El conector solicitará vales de sesión y claves de sesión temporales del servicio Kerberos KDC. El servicio Kerberos KDC se coloca convencionalmente con el controlador de dominio.

Si no se especifica Kerberos KDC, el conector intentará detectar estas propiedades automáticamente desde las siguientes ubicaciones:

• KRB5 Config File (krb5.ini/krb5.conf): Si se establece la variable de ambiente KRB5_CONFIG y el archivo existe, el conector obtendrá el KDC del archivo especificado. De lo contrario, intentará leer desde la ubicación MIT predeterminada según el sistema operativo: C:\ProgramData\MIT\Kerberos5\krb5.ini (Windows) o /etc/krb5.conf (Linux)
• Java System Properties: Utilizando las propiedades del sistema java.security.krb5.realm y java.security.krb5.kdc.
• Domain Name and Host: El conector inferirá Kerberos Realm y Kerberos KDC a partir del nombre de dominio y el alojar configurados como último recurso.

Nota: La autenticación de Windows solo es compatible con JRE 1.6 y superior.

Reino de Kerberos¶

El reino de Kerberos utilizado para autenticar al usuario.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Las propiedades de Kerberos se usan cuando se usa SPNEGO o la autenticación de Windows. Kerberos Realm se utiliza para autenticar al usuario con el servicio de distribución de claves Kerberos (KDC). Un administrador puede configurar Kerberos Realm para que sea cualquier cadena, pero convencionalmente se basa en el nombre de dominio.

Si no se especifica Kerberos Realm, el conector intentará detectar estas propiedades automáticamente desde las siguientes ubicaciones:

• KRB5 Config File (krb5.ini/krb5.conf): Si se establece la variable de ambiente KRB5_CONFIG y el archivo existe, el conector obtendrá el dominio predeterminado del archivo especificado. De lo contrario, intentará leer desde la ubicación MIT predeterminada según el sistema operativo: C:\ProgramData\MIT\Kerberos5\krb5.ini (Windows) o /etc/krb5.conf (Linux)
• Java System Properties: Utilizando las propiedades del sistema java.security.krb5.realm y java.security.krb5.kdc.
• Domain Name and Host: El conector inferirá Kerberos Realm y Kerberos KDC a partir del nombre de dominio y el alojar configurados por el usuario como último recurso. Esto podría funcionar en algunos ambientes de Windows.

Nota: La autenticación basada en Kerberos solo es compatible con JRE 1.6 y versiones posteriores.

KerberosSPN¶

El nombre principal de servicio (SPN) para el controlador de dominio Kerberos.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Si el SPN en el controlador de dominio Kerberos no es el mismo que la URL en la que se está autenticando, use esta propiedad para establecer el SPN.

KerberosKeytabFile¶

El archivo Keytab que contiene sus pares de principales de Kerberos y claves cifradas.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

El archivo Keytab que contiene sus pares de principales de Kerberos y claves cifradas.

KerberosServiceRealm¶

El dominio Kerberos del servicio.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

El KerberosServiceRealm es la especificación del dominio Kerberos del servicio cuando se utiliza la autenticación Kerberos entre dominios.

En la mayoría de los casos, se utiliza un solo dominio y una máquina KDC para realizar la autenticación Kerberos y esta propiedad no es necesaria.

Esta propiedad está disponible para configuraciones complejas en las que se utilizan un reino y una máquina KDC diferentes para obtener un vale de autenticación (solicitud AS) y un vale de servicio (solicitud TGS).

KerberosServiceKDC¶

El KDC de Kerberos del servicio.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

El KerberosServiceKDC se usa para especificar el servicio Kerberos KDC cuando se usa la autenticación Kerberos entre dominios.

En la mayoría de los casos, se utiliza un solo dominio y una máquina KDC para realizar la autenticación Kerberos y esta propiedad no es necesaria.

Esta propiedad está disponible para configuraciones complejas en las que se utilizan un reino y una máquina KDC diferentes para obtener un vale de autenticación (solicitud AS) y un vale de servicio (solicitud TGS).

KerberosTicketCache¶

La ruta completa del archivo a un archivo de caché de credenciales de MIT Kerberos.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Esta propiedad se puede configurar si desea utilizar un archivo de caché de credenciales que se creó mediante el comando kinit o el administrador de tickets de MIT Kerberos.

SSL¶

Esta sección proporciona una lista completa de las propiedades SSL que puede configurar.

SSLClientCert¶

El almacén de certificados de cliente TLS/SSL para la autenticación de cliente SSL (SSL bidireccional).

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

El nombre del almacén de certificados para el certificado de cliente.

El SSLClientCertType especifica el tipo de almacén de certificados especificado por SSLClientCert. Si la tienda está protegida con contraseña, especifique la contraseña en SSLClientCertPassword.

SSLClientCert se usa junto con SSLClientCertSubject para especificar certificados de cliente. Si SSLClientCert tiene un valor y SSLClientCertSubject, se inicia una búsqueda de un certificado. Vea SSLClientCertSubject para más información.

Las designaciones de los almacenes de certificados dependen de la plataforma.

Las siguientes son designaciones de los almacenes de certificados de usuario y máquina más comunes en Windows:

En Java, el almacén de certificados normalmente es un archivo que contiene certificados y claves privadas opcionales.

Cuando el tipo de almacén de certificados es PFXFile, esta propiedad debe establecerse en el nombre del archivo. Cuando el tipo es PFXBlob, la propiedad debe establecerse en el contenido binario de un archivo PFX (por ejemplo, almacén de certificados PKCS12).

SSLClientCertType¶

El tipo de almacén de claves que contiene el certificado de cliente TLS/SSL.

Valores Posibles¶

USER, MACHINE, PFXFILE, PFXBLOB, JKSFILE, JKSBLOB, PEMKEY_FILE, PEMKEY_BLOB, PUBLIC_KEY_FILE, PUBLIC_KEY_BLOB, SSHPUBLIC_KEY_FILE, SSHPUBLIC_KEY_BLOB, P7BFILE, PPKFILE, XMLFILE, XMLBLOB

Tipo de Datos¶

string

Valor por Defecto¶

"USER"

Observaciones¶

Esta propiedad puede tomar uno de los siguientes valores:

SSLClientCertPassword¶

La contraseña para el certificado de cliente TLS/SSL.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Si el almacén de certificados es de un tipo que requiere una contraseña, esta propiedad se utiliza para especificar esa contraseña para abrir el almacén de certificados.

SSLClientCertSubject¶

El asunto del certificado de cliente TLS/SSL.

Tipo de Datos¶

string

Valor por Defecto¶

"\*"

Observaciones¶

Al cargar un certificado, el asunto se utiliza para ubicar el certificado en el almacén.

Si no se encuentra una coincidencia exacta, se busca en la tienda temas que contengan el valor de la propiedad. Si aún no se encuentra una coincidencia, la propiedad se establece en una cadena vacía y no se selecciona ningún certificado.

El valor especial "*" selecciona el primer certificado en el almacén de certificados.

El asunto del certificado es una lista separada por comas de valores y campos de nombre distinguido. Por ejemplo, "CN=www.server.com, OU=test, C=US, E=support@company.com". Los campos comunes y sus significados se muestran a continuación.

Si un valor de campo contiene una coma, debe estar entre comillas.

SSLServerCert¶

El certificado que se aceptará del servidor al conectarse mediante TLS/SSL.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Si usa una conexión TLS/SSL, esta propiedad se puede usar para especificar el certificado TLS/SSL que se aceptará del servidor. Se rechaza cualquier otro certificado que no sea de confianza para la máquina.

Esta propiedad puede tomar las siguientes formas:

Si no se especifica, se acepta cualquier certificado en el que confíe la máquina.

La máquina valida los certificados como confiables según el almacén de confianza del sistema. El almacén de confianza utilizado es el valor 'javax.net.ssl.trustStore' especificado para el sistema. Si no se especifica ningún valor para esta propiedad, se utiliza el almacén de confianza predeterminado de Java (por ejemplo, JAVA_HOME\lib\security\cacerts).

Use '*' para indicar que acepta todos los certificados. Tenga en cuenta que esto no se recomienda debido a problemas de seguridad.

SSH¶

Esta sección proporciona una lista completa de las propiedades de SSH que puede configurar.

SSHAuthMode¶

El método de autenticación que se utilizará para iniciar sesión en un servidor SFTP.

Valores Posibles¶

None, Password, Public_Key

Tipo de Datos¶

string

Valor por Defecto¶

"Password"

Observaciones¶

• Ninguno: no se realizará ninguna autenticación. El Usuario actual se ignora y la conexión se iniciará como anónima.
• Contraseña: El conector utilizará los valores de Usuario y contraseña para autenticar al usuario.
• Public_Key: El conector utilizará los valores de Usuario y SSHClientCert para autenticar al usuario. SSHClientCert debe tener una clave privada disponible para que este método de autenticación tenga éxito.

SSHClientCert¶

Un certificado que se utilizará para autenticar al usuario.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Para utilizar la autenticación de clave pública, SSHClientCert debe contener un certificado con una clave privada válida. El valor de la clave pública del certificado se envía al servidor junto con una firma generada con la clave privada. El servidor primero verificará si los valores de la clave pública coinciden con lo que conoce el usuario y luego intentará usar esos valores para verificar la firma.

El SSHClientCertType especifica el tipo de almacén de certificados especificado por SSHClientCert. Si la tienda está protegida con contraseña, especifique la contraseña en SSHClientCertPassword.

SSHClientCert se usa junto con SSHClientCertSubject para especificar certificados de cliente. Si SSHClientCert tiene un valor y SSHClientCertSubject, se inicia una búsqueda de un certificado. Consulte SSHClientCertSubject campo para más detalles.

Las designaciones de los almacenes de certificados dependen de la plataforma.

Las siguientes son designaciones de los almacenes de certificados de usuario y máquina más comunes en Windows:

En Java, el almacén de certificados normalmente es un archivo que contiene certificados y claves privadas opcionales.

Cuando el tipo de almacén de certificados es PFXFile, esta propiedad debe establecerse en el nombre del archivo. Cuando el tipo es PFXBlob, la propiedad debe establecerse en el contenido binario de un archivo PFX (es decir, almacén de certificados PKCS12).

SSHClientCertPassword¶

La contraseña del certificado SSHClientCert si lo tiene.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Esta propiedad solo se usa cuando se autentica en servidores SFTP con SSHAuthMode establecido en PublicKey y SSHClientCert establecido en una clave privada.

SSHClientCertSubject¶

El asunto del certificado de cliente SSH.

Tipo de Datos¶

string

Valor por Defecto¶

"\*"

Observaciones¶

Al cargar un certificado, el asunto se utiliza para ubicar el certificado en el almacén.

Si no se encuentra una coincidencia exacta, se busca en la tienda temas que contengan el valor de la propiedad.

Si aún no se encuentra una coincidencia, la propiedad se establece en una cadena vacía y no se selecciona ningún certificado.

El valor especial "*" selecciona el primer certificado en el almacén de certificados.

El asunto del certificado es una lista separada por comas de valores y campos de nombre distinguido. Por ejemplo, "CN=www.server.com, OU=test, C=US, E=support@jitterbit.com". Los campos comunes y sus significados se muestran a continuación.

Si un valor de campo contiene una coma, debe estar entre comillas.

SSHClientCertType¶

El tipo de certificado SSHClientCert.

Valores Posibles¶

USER, MACHINE, PFXFILE, PFXBLOB, JKSFILE, JKSBLOB, PEMKEY_FILE, PEMKEY_BLOB, PUBLIC_KEY_FILE, PUBLIC_KEY_BLOB, SSHPUBLIC_KEY_BLOB, P7BFILE, P7BBLOB, SSHPUBLIC_KEY_FILE, PPKFILE, PPKBLOB, XMLFILE, XMLBLOB

Tipo de Datos¶

string

Valor por Defecto¶

"PUBLIC_KEY_FILE"

Observaciones¶

El tipo de SSHClientCert certificado. Esta propiedad puede tomar uno de los siguientes valores:

Servidor SSH¶

El servidor SSH.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

El servidor SSH.

Puerto SSH¶

El puerto SSH.

Tipo de Datos¶

string

Valor por Defecto¶

"22"

Observaciones¶

El puerto SSH.

SSHUser¶

El usuario SSH.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

El usuario SSH.

Contraseña SSH¶

La contraseña SSH.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

La contraseña SSH.

Huella Digital del Servidor SSH¶

La huella digital del servidor SSH.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

La huella digital del servidor SSH.

Usar SSH¶

Ya sea para tunelizar la conexión de Cassandra a través de SSH. Usa SSH.

Tipo de Datos¶

bool

Valor por Defecto¶

false

Observaciones¶

De forma predeterminada, el conector intentará conectarse directamente a Cassandra. Cuando esta opción está habilitada, el conector establecerá una conexión SSH con el SSHServer y canalizar la conexión a Cassandra a través de él.

Esquema¶

Esta sección proporciona una lista completa de propiedades de esquema que puede configurar.

Ubicación¶

Una ruta al directorio que contiene los archivos de esquema que definen tablas, vistas y procedimientos almacenados.

Tipo de Datos¶

string

Valor por Defecto¶

"%APPDATA%\\\Cassandra Data Provider\\Schema"

Observaciones¶

La ruta a un directorio que contiene los archivos de esquema para el conector (archivos .rsd para tablas y vistas, archivos .rsb para procedimientos almacenados). La ubicación de la carpeta puede ser una ruta relativa desde la ubicación del ejecutable. El Location La propiedad solo es necesaria si desea personalizar las definiciones (por ejemplo, cambiar el nombre de una columna, ignorar una columna, etc.) o ampliar el modelo de datos con nuevas tablas, vistas o procedimientos almacenados.

Si no se especifica, la ubicación predeterminada es "%APPDATA%\\Cassandra Data Provider\Schema" con %APPDATA% estando configurado en el directorio de configuración del usuario:

Esquemas Navegables¶

Esta propiedad restringe los esquemas informados a un subconjunto de los esquemas disponibles. Por ejemplo, BrowsableSchemas=SchemaA,SchemaB,SchemaC.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Enumerar los esquemas de las bases de datos puede resultar costoso. Proporcionar una lista de esquemas en la cadena de conexión mejora el rendimiento.

Mesas¶

Esta propiedad restringe las tablas notificadas a un subconjunto de las tablas disponibles. Por ejemplo, Tablas=TablaA,TablaB,TablaC.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Listar las tablas de algunas bases de datos puede resultar costoso. Proporcionar una lista de tablas en la cadena de conexión mejora el rendimiento del conector.

Esta propiedad también se puede utilizar como una alternativa a la lista automática de vistas si ya sabe con cuáles quiere trabajar y, de lo contrario, habría demasiadas para trabajar.

Especifique las tablas que desea en una lista separada por comas. Cada tabla debe ser un identificador SQL válido con cualquier carácter especial escapado usando corchetes, comillas dobles o acentos graves. Por ejemplo, Tables=TableA,[TableB/WithSlash],WithCatalog.WithSchema.`TableC With Space`.

Tenga en cuenta que al conectarse a una fuente de datos con varios esquemas o catálogos, deberá proporcionar el nombre completo de la tabla en esta propiedad, como en el último ejemplo aquí, para evitar la ambigüedad entre las tablas que existen en varios catálogos o esquemas.

Puntos de Vista¶

Restringe las vistas informadas a un subconjunto de las tablas disponibles. Por ejemplo, Vistas=VistaA,VistaB,VistaC.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Listar las vistas de algunas bases de datos puede ser costoso. Proporcionar una lista de vistas en la cadena de conexión mejora el rendimiento del conector.

Esta propiedad también se puede utilizar como una alternativa a la lista automática de vistas si ya sabe con cuáles quiere trabajar y, de lo contrario, habría demasiadas para trabajar.

Especifique las vistas que desee en una lista separada por comas. Cada vista debe ser un identificador SQL válido con cualquier carácter especial escapado usando corchetes, comillas dobles o acentos graves. Por ejemplo, Views=ViewA,[ViewB/WithSlash],WithCatalog.WithSchema.`ViewC With Space`.

Tenga en cuenta que al conectarse a una fuente de datos con varios esquemas o catálogos, deberá proporcionar el nombre completo de la tabla en esta propiedad, como en el último ejemplo aquí, para evitar la ambigüedad entre las tablas que existen en varios catálogos o esquemas.

Misceláneas¶

Esta sección proporciona una lista completa de propiedades misceláneas que puede configurar.

Agregaciones Admitidas¶

Si admitir o no agregaciones en el servidor Cassandra. Tenga en cuenta que en las consultas al proveedor, debe usar comillas simples para definir cadenas.

Tipo de Datos¶

bool

Valor por Defecto¶

true

Observaciones¶

Permitir Filtrado¶

Cuando es verdadero, las consultas de rendimiento lento se procesan en el servidor.

Tipo de Datos¶

bool

Valor por Defecto¶

false

Observaciones¶

Cassandra, de forma predeterminada, no permite el filtrado de consultas que predice que tendrán problemas de rendimiento. Estas consultas incluyen el filtrado en una columna que no es la clave principal. Cuando SupportEnhancedSQL está habilitado, el conector analiza las consultas en la memoria con el motor SQL, en lugar de descargar el procesamiento de la consultar a la base de datos.

Puede anular el comportamiento predeterminado y confiar en el servidor para procesar estas consultas configurando AllowFiltering a verdadero.

Sensibilidad de Mayúsculas y Minúsculas¶

Habilite la distinción entre mayúsculas y minúsculas para el envío de CQL al servidor, si se establece en True, los identificadores en el CQL se escribirán entre comillas dobles.

Tipo de Datos¶

bool

Valor por Defecto¶

true

Observaciones¶

De forma predeterminada, SQL no distingue entre mayúsculas y minúsculas. Sin embargo, Cassandra admite nombres de columnas y tablas que distinguen entre mayúsculas y minúsculas. Establecer esta propiedad en True le permitirá recuperar tablas y columnas en función de sus nombres que distinguen entre mayúsculas y minúsculas.

Nivel de Consistencia¶

El nivel de consistencia determina cuántas de las réplicas de los datos con los que está interactuando deben responder para que la consultar se considere exitosa.

Valores Posibles¶

ONE, TWO, THREE, QUORUM, ALL, LOCAL_QUORUM, EACH_QUORUM, SERIAL, LOCAL_SERIAL, LOCAL_ONE, ANY

Tipo de Datos¶

string

Valor por Defecto¶

"ONE"

Observaciones¶

El nivel de consistencia determina cuántas de las réplicas de los datos con los que está interactuando deben responder para que la consultar se considere exitosa. Debe especificar las réplicas apropiadas en el Servidor propiedad.

A continuación se muestran los valores posibles:

• ANY: al menos una réplica debe devolver el éxito en una operación de escritura. Esta propiedad garantiza que una escritura nunca falle; este nivel de consistencia ofrece la consistencia más baja y la disponibilidad más alta.
• ALL: Todas las réplicas deben responder. Esta propiedad proporciona la mayor consistencia y la menor disponibilidad.
• UNO: Al menos una réplica debe responder. Este es el valor predeterminado y adecuado para la mayoría de los usuarios, que normalmente no requieren una alta consistencia.
• DOS: Al menos dos réplicas deben responder.
• TRES: Al menos tres réplicas deben responder.
• QUÓRUM: Debe responder un quórum de nodos. Las propiedades QUORUM proporcionan alta consistencia con cierta tolerancia a fallas.
• EACH_QUORUM: Debe responder un quórum de nodos donde se calcula un quórum para cada centro de datos. Esta configuración mantiene la coherencia en cada centro de datos.
• SERIAL: Un quórum de réplicas realiza un algoritmo de consenso para permitir transacciones ligeras.
• LOCAL_ONE: al menos una réplica en el centro de datos local debe responder.
• LOCAL_SERIAL: El algoritmo de consenso se calcula para el centro de datos local.
• LOCAL_QUORUM: Debe responder un quórum de nodos donde se calcula el quórum para el centro de datos local.

FlattenArrays¶

De forma predeterminada, las matrices anidadas se devuelven como cadenas de JSON. La propiedad FlattenArrays se puede usar para aplanar los elementos de matrices anidadas en columnas propias. Establezca FlattenArrays en la cantidad de elementos que desea devolver de las matrices anidadas.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

De forma predeterminada, las matrices anidadas se devuelven como cadenas de JSON. El FlattenArrays La propiedad se puede usar para aplanar los elementos de matrices anidadas en columnas propias. Esto solo se recomienda para arreglos que se espera que sean cortos.

Colocar FlattenArrays a la cantidad de elementos que desea devolver de las matrices anidadas. Los elementos especificados se devuelven como columnas. El índice de base cero se concatena con el nombre de la columna. Se ignoran otros elementos.

Por ejemplo, puede devolver un número arbitrario de elementos de una matriz de cadenas:

["FLOW-MATIC","LISP","COBOL"]

Cuando FlattenArrays se establece en 1, la matriz anterior se aplana en la siguiente tabla:

FlattenObjects¶

Establezca FlattenObjects en true para aplanar las propiedades de los objetos en sus propias columnas. De lo contrario, los objetos anidados en matrices se devuelven como cadenas de JSON.

Tipo de Datos¶

bool

Valor por Defecto¶

false

Observaciones¶

Colocar FlattenObjects a verdadero para aplanar las propiedades del objeto en columnas propias. De lo contrario, los objetos anidados en matrices se devuelven como cadenas de JSON. El nombre de la propiedad se concatena con el nombre del objeto con un guión bajo para generar el nombre de la columna.

Por ejemplo, puede aplanar los objetos anidados a continuación en el momento de la conexión:

[
     { "grade": "A", "score": 2 },
     { "grade": "A", "score": 6 },
     { "grade": "A", "score": 10 },
     { "grade": "A", "score": 9 },
     { "grade": "B", "score": 14 }
]

Cuando FlattenObjects se establece en verdadero y FlattenArrays se establece en 1, la matriz anterior se aplana en la siguiente tabla:

Filas Máximas¶

Limita el número de filas devueltas cuando no se usa agregación o agrupación en la consultar. Esto ayuda a evitar problemas de rendimiento en el momento del diseño.

Tipo de Datos¶

int

Valor por Defecto¶

-1

Observaciones¶

Limita el número de filas devueltas cuando no se usa agregación o agrupación en la consultar. Esto ayuda a evitar problemas de rendimiento en el momento del diseño.

NullToUnset¶

Use unset en lugar de NULL en la consultar CQL cuando realice operaciones INSERT.

Tipo de Datos¶

bool

Valor por Defecto¶

false

Observaciones¶

En Cassandra 2.2 y versiones posteriores, al ejecutar una consultar INSERT, el valor de un parámetro se puede establecer en no establecido. Cassandra no considera los valores de campo no establecidos, lo que ayuda a evitar las lápidas.

Cuando se insertan valores NULL, es posible alcanzar los límites del umbral de desecho, lo que provoca que se produzca una excepción al consultar los datos. Establecer esta propiedad en true y enviar valores no establecidos evita que se creen estos desecho.

Nota: esta opción solo está disponible en las operaciones INSERTAR, ya que Cassandra no admite cambiar los valores existentes para desactivarlos.

Otro¶

Estas propiedades ocultas se usan solo en casos de uso específicos.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Las propiedades enumeradas a continuación están disponibles para casos de uso específicos. Los casos de uso y la funcionalidad normales del controlador no deberían requerir estas propiedades.

Especifique varias propiedades en una lista separada por punto y coma.

Integración y Formateo¶

Tamaño de Página¶

El número máximo de resultados a devolver por página de Cassandra.

Tipo de Datos¶

int

Valor por Defecto¶

5000

Observaciones¶

El Pagesize la propiedad afecta el número máximo de resultados a devolver por página de Cassandra. Establecer un valor más alto puede resultar en un mejor rendimiento a costa de memoria adicional asignada por página consumida.

Pseudocolumnas¶

Esta propiedad indica si incluir o no pseudocolumnas como columnas en la tabla.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Esta configuración es particularmente útil en Entity Framework, que no le permite establecer un valor para una pseudocolumna a menos que sea una columna de tabla. El valor de esta configuración de conexión tiene el formato "Tabla1=Columna1, Tabla1=Columna2, Tabla2=Columna3". Puede usar el carácter "*" para incluir todas las tablas y todas las columnas; por ejemplo, "*=*".

Transferencia de Consultas¶

Esta opción pasa la consultar al servidor Cassandra tal cual.

Tipo de Datos¶

bool

Valor por Defecto¶

false

Observaciones¶

Cuando se establece esto, las consultas se pasan directamente a Cassandra.

FilaExploraciónProfundidad¶

El número máximo de filas para escanear para buscar las columnas disponibles en una tabla.

Tipo de Datos¶

int

Valor por Defecto¶

100

Observaciones¶

Las columnas de una tabla deben determinarse escaneando las filas de la tabla. Este valor determina el número máximo de filas que se escanearán.

Establecer un valor alto puede disminuir el rendimiento. Establecer un valor bajo puede evitar que el tipo de datos se determine correctamente, especialmente cuando hay datos nulos.

Se Acabó el Tiempo¶

El valor en segundos hasta que se lanza el error de tiempo de espera, cancelando la operación.

Tipo de Datos¶

int

Valor por Defecto¶

60

Observaciones¶

Si Timeout = 0, las operaciones no expiran. Las operaciones se ejecutan hasta que se completan correctamente o hasta que encuentran una condición de error.

Si Timeout caduca y la operación aún no se ha completado, el conector genera una excepción.

UsarJsonFormat¶

Si enviar y devolver la codificación JSON para los tipos de datos CQL.

Tipo de Datos¶

bool

Valor por Defecto¶

true

Observaciones¶

Cassandra 2.2 introdujo una extensión CQL que le permite codificar en JSON tipos de datos CQL. De forma predeterminada, utiliza la sintaxis JSON para manipular datos y las declaraciones SELECT devuelven JSON a través del conector. Establezca esta propiedad en false para usar literales CQL para interactuar con los datos de Cassandra.

La sintaxis de los literales CQL tiene varias diferencias con JSON. Por ejemplo:

• Las cadenas CQL se definen entre comillas simples, mientras que las cadenas JSON se definen entre comillas dobles.
• Los conjuntos, las tuplas y las listas de CQL están codificados en JSON como matrices.
• Tipos definidos por el usuario y CQL uuid los tipos están codificados en JSON como objetos.

Consulte la documentación de CQL para obtener más información sobre cómo codificar tipos de datos JSON en su versión de Cassandra. A continuación se muestra un ejemplo de instrucción SQL que utiliza JSON y CQL.

INSERTAR EN usuarios (user_id, correos) VALORES(@user_id, @ correos)

INSERTAR EN usuarios (user_id, correos) VALORES (@user_id, @ correos)

Tenga en cuenta que en las consultas al conector, debe usar comillas simples para definir cadenas.

VarintToString¶

Asigne Cassandra VARINT al valor de cadena.

Tipo de Datos¶

bool

Valor por Defecto¶

true

Observaciones¶

Asigne Cassandra VARINT al valor de cadena.