AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Este contenido se ha traducido automáticamente.  Haga clic aquí  para ver la versión en inglés.
Ayuda / Conectores Nativos/Accesos Nativos / Conector Nativo MariaDB
  • 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
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Otros
Procedimientos almacenados
Conector Nativo MariaDB: Requisitos y observaciones
Conectores NativosDisponible solo con este tipo de conexión
Presentación
Esta Page presenta los principales aspectos y requisitos del Native MariaDB Connector.
Principales observaciones

Versiones necesarias

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

HCreation crea tablas "InnoDB" para soportar bloqueos y transacciones. Para obtener más información, consulte Conector Nativo MariaDB: Características específicas.

Soporte para Unicode

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.
Para más detalles sobre las conexiones Unicode o ANSI, consulte Programación de una base de datos MariaDB con las funciones HFSQL.

Conexión con certificados SSL

Para establecer una conexión con SSL Certificate, debe:
  1. Instalar una versión del servidor MariaDB que soporte las conexiones SSL. Para más detalles, consulte la documentación de MariaDB.
  2. Crear los certificados necesarios.
  3. Establezca una conexión utilizando las siguientes palabras clave en la información avanzada de la conexión:
    Palabra claveaprovechamiento
    clave SSLRuta del archivo clave.
    Certificado SSLRuta del archivo de Certificate.
    SSL CARuta del archivo de la autoridad de certificación.
    SSL CAPathRuta del directorio que contiene los certificados de las autoridades de certificación SLL reconocidas, en formato PEM.
    Cifrado SSLLista 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.
Para obtener más información, consulte Información opcional de conexión.
Requisitos generales

Bloqueo de registros

Las opciones de bloqueo (hLockWrite y hLockReadWrite constantes) que se pueden utilizar con las funciones HFSQL no están soportadas en esta versión.
Para obtener más información, consulte Conector Nativo MariaDB: Características específicas.

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.
Para obtener más información, consulte Conector Nativo MariaDB: Características específicas.

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íficosFunciones 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
Versión mínima requerida
  • Versión 20
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 10/03/2023

Señalar un error o enviar una sugerencia | Ayuda local