|
|
|
|
- Presentación
- Principales observaciones
- Versiones necesarias
- Uso de los comandos de WLanguage en las consultas SQL
- Limitaciones de MariaDB versión 3.23x
- Gestión de archivos de gran tamaño
- INSERTAR consultas e identificador de automatic
- Creación de una tabla con HCreation
- Soporte para Unicode
- Conexión con certificados SSL
- Requisitos generales
- Bloqueo de registros
- Registros idénticos
- Transacciones
- Artículos de set o ENUM
- Posiciones de xBlob
- Campos de tipo Array
- Usando las consultas INSERTAR/ACTUALIZAR para insertar texto en un ítem LONGBLOB (memo binario) en MariaDB
- Partial indexación de memos e indexación de texto completo
- Requisitos específicos para HFSQL y las funciones SQL
Conector Nativo MariaDB: Requisitos y observaciones
Disponible solo con este tipo de conexión
Esta Page presenta los principales aspectos y requisitos del Native MariaDB Connector. Principales observaciones Atención: Esta versión del Conector Nativo MariaDB funciona con:
- WINDEV o WEBDEV 2024.
- Biblioteca cliente MariaDB (archivo libmariadb.DLL)
- Biblioteca de cliente de 32 bits para utilizar el conector MariaDB nativo de 32 bits (versión 3.x.x a 10.x.x probada).
- Biblioteca de cliente de 64 bits para utilizar el conector MariaDB nativo de 64 bits (versión 10.x.x probada).
- La DLL LibMariaDB.DLL debe ser:
- En el ordenador de desarrollo:
- en el directorio "\Programas\Framework\Win32x86" del directorio de instalación de WINDEV o WEBDEV (32 bits).
- en el directorio "\Programas\Framework\Win64x86" del directorio de instalación de WINDEV o WEBDEV (64 bits).
- En el ordenador de implementación, en el directorio de los ejecutables o en el directorio de Windows. Para una implementación en un servidor Web, la DLL debe encontrarse en el directorio de la Conector Nativo o en el directorio de Windows.
Uso de los comandos de WLanguage en las consultas SQL Los comandos de WLanguage no pueden utilizarse en las consultas SQL. Limitaciones de MariaDB versión 3.23x La base de datos MariaDB versión 3.23x no es compatible: - la búsqueda de Partial. El uso de Partial Fetch con las funciones SQL de WLanguage tiene el mismo efecto que si no se usara Partial Fetch.
- los sindicatos.
Gestión de archivos de gran tamaño Cuando se manejan archivos grandes, todos los registros se cargan en la memoria. Para reducir el uso de la memoria, se recomienda: - utilizar un filtro (HFilter) antes de inicializar una búsqueda (HReadFirst/HReadLast, ...).
- utilizar consultas cuyas condiciones de selección sean suficientemente selectivas.
- evitar realizar búsquedas.
INSERTAR consultas e identificador de automatic Los identificadores automatic no son compatibles con las consultas INSERT (creadas mediante programación o en el editor de consultas). Para utilizar un identificador automatic, llame a HAdd en el tabla. Creación de una tabla con HCreation Cuando la conexión soporta Unicode (modo predeterminado), los elementos de texto de las consultas ejecutadas con la constante hQueryWithoutCorrection adoptan el formato Unicode. Si se asigna una cadena Unicode a una cadena Ansi, WINDEV y WEBDEV realizan automáticamente la conversión utilizando el carácter set definido con ChangeCharset. Si la conexión es ANSI ("WD Unicode Support = 0" en la información extendida especificada por HDescribeConnection o HOpenConnection), los elementos de texto de las consultas ejecutadas con la constante hQueryWithoutCorrection están en formato ANSI. Conexión con certificados SSL Para establecer una conexión con SSL Certificate, debe: - Instalar una versión del servidor MariaDB que soporte las conexiones SSL. Para más detalles, consulte la documentación de MariaDB.
- Crear los certificados necesarios.
- Establezca una conexión utilizando las siguientes palabras clave en la información avanzada de la conexión:
| | Palabra clave | aprovechamiento |
---|
clave SSL | Ruta del archivo clave. | Certificado SSL | Ruta del archivo de Certificate. | SSL CA | Ruta del archivo de la autoridad de certificación. | SSL CAPath | Ruta del directorio que contiene los certificados de las autoridades de certificación SLL reconocidas, en formato PEM. | Cifrado SSL | Lista de cifras autorizadas. |
Ejemplo de conexión SSL en la base de datos CRM del servidor mariadbserver.domain.fr: MyConnection is Connection // Describe the connection MyConnection.User = "root" MyConnection.Password = "secret" MyConnection.Server = "mariadbserver.domain.fr" MyConnection.Database = "CRM" MyConnection.Provider = hNativeAccessMariaDB MyConnection.Access = hOReadWrite // Describe the extended information for an SSL connection MyConnection.ExtendedInfo = [ SSL KEY = E:\MySSLCertificates\mariadb.key; SSL CERT = E:\MySSLCertificates\mariadb_cert.pem; SSL CA = E:\MySSLCertificates\ca-cert.pem; SSL CAPATH = E:\MySSLCertificates\CA\ ] // Open the connection HOpenConnection(MyConnection)
Observación: Estos parámetros corresponden a los parámetros de la función mysql_ssl_set de la C API para acceder a MariaDB. Las opciones de bloqueo (hLockWrite y hLockReadWrite constantes) que se pueden utilizar con las funciones HFSQL no están soportadas en esta versión. Registros idénticos El Native MariaDB Connector no puede diferenciar entre dos registros idénticos (es decir, con valores idénticos para todos los artículos, excluyendo los artículos individuales). Cuando se modifica o elimina una Record, se modifican o eliminan todas las Record idénticas. Transacciones Para gestionar las transacciones, debe utilizar un tipo de MariaDB tabla que soporte los comandos BEGIN, COMMIT y ROLLBACK. Artículos de set o ENUM Los elementos set y ENUM se procesan e importan automáticamente como nota de texto en WINDEV y WEBDEV. De hecho, los elementos set y ENUM no tienen equivalencia en HFSQL. Contienen valores numéricos (índices) que se corresponden con valores de "texto". Estos son los valores de "texto" que se importan. Posiciones de xBlob Las posiciones xBlob en MariaDB se procesan automáticamente y se importan como nota de texto en WINDEV y WEBDEV: - las partidas BLOB se importan como partidas pro memoria binaria.
- las posiciones LONGTEXT se importan como posiciones de nota de texto.
Campos de tipo Array Los artículos de array no están soportados por el Conector Nativo. Si está utilizando un elemento array, sólo el valor del índice 1 en la array será manejado por las funciones HFSQL (lectura/escritura). Usando las consultas INSERTAR/ACTUALIZAR para insertar texto en un ítem LONGBLOB (memo binario) en MariaDB Para permitir la gestión de los elementos Unicode, las conexiones del Native MariaDB Connector se abren en UTF8: todas las peticiones y los datos se intercambian en UTF8 con el servidor. El servidor convierte la petición y los valores en el conjunto de caracteres correspondiente a cada columna, excepto en el caso de la columna LONGBLOB partida (nota binaria): en este caso, el valor se inserta tal cual. Para un artículo LONGBLOB: - si la conexión está en formato ANSI, el valor de texto insertado está en formato ANSI.
- si la conexión está en formato UTF8, el valor del texto insertado está en formato UTF8; en este caso, puede producirse un problema de compatibilidad.
Para evitar este problema de conversión en UTF8, puede hacerlo: Partial indexación de memos e indexación de texto completo La indexación de los memorandos de Partial, así como la indexación del texto completo no se tienen en cuenta: - al importar tablas MariaDB en el análisis.
- cuando se utiliza HCreation.
Si estas características se definen en el análisis, se tendrán en cuenta al ejecutar las consultas SQL (con la constante hQueryWithoutCorrection) que utilizan las funciones SQL "CREATE TABLE" y "MATCH AGAINST". Requisitos específicos para HFSQL y las funciones SQL Los requisitos específicos para utilizar HFSQL y las funciones SQL con el conector MariaDB nativo son los siguientes: | | Requisitos específicos | Funciones afectadas |
---|
Consulta multiarchivo: Las funciones HAdd, HModify y HDelete no están soportadas. | HAdd HModify HDelete | Las búsquedas realizadas en algunas consultas complejas con HReadSeek* pueden fallar en esta versión. Este problema se solucionará en una próxima versión. | HReadSeek, HReadSeekFirst, HReadSeekLast | Cuando se utiliza el Native MariaDB Connector, se debe especificar la "DataBase" utilizada. Si utiliza la función HConnect, se debe especificar la "Base de datos" en la información adicional de la siguiente manera: "catálogo inicial = Nombre de la base de datos" | HConnect | Al crear tablas con la función HCreation, los nombres de las tablas no deben contener acentos (ejemplo: "ElanFile"). Este es un problema específico de MariaDB (verificado en las versiones 3.23.52-max-nt y 3.23.47-max-nt del servidor MariaDB). La ejecución del comando SQL "DROP TABLE", realizado por HCreation para eliminar el tabla si ya existe, puede provocar una parada inesperada del servidor MariaDB. Para obtener más información, consulte Conector Nativo MariaDB: Características específicas. | HCreation |
Esta página también está disponible para…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|