Documentación de Velneo
29
29
  • Introducción
  • Velneo
    • Requerimientos de Velneo
    • Notas de la versión
    • Funcionalidades comunes a los componentes de Velneo
      • Instalación
      • Conexión con Velneo vServer
      • Cambiar el estilo de visualización
      • Ver u ocultar barras de herramientas
      • Mensajería interna entre usuarios
      • Soporte de alta resolución (HighDPI)
      • Carpetas de trabajo de los componentes de Velneo
      • Numeración de versiones de Velneo
      • Certificado de firma digital para componentes de Windows
    • Tipos de archivo generados por Velneo
    • Velneo Web
      • Plataformas y navegadores compatibles
      • Acceso a recursos del sistema
      • Siempre https
      • Funcionamiento de vatp por websocket
      • CORS para llamadas xmlhttprequest
  • Velneo vDevelop
    • ¿Qué es Velneo vDevelop?
    • Interfaz de Velneo vDevelop
      • Menú Soluciones
      • Menú Proyectos
      • Menú Objetos
      • Menú Scripts
      • Menú Edición
      • Menú Ver
      • Menú Componentes
      • Menú Ayuda
    • Lista de teclas aceleradoras de Velneo vDevelop
    • Soluciones y proyectos
    • Control y edición de proyectos
    • Herencia
    • Inspectores
    • Proyectos objetos y editores
      • Proyecto de datos
      • Proyecto de aplicación
        • Crear CSS para aplicar a objetos en edición
      • Objeto
      • Objetos de proyecto de datos
        • Indice complejo
        • Tabla
          • Actualización
          • Campo
          • Enlace
          • Indice
          • Plural
          • Traspaso de campo
          • Trigger
        • Tabla estática
        • Variable
      • Objetos de proyecto de aplicación
        • Acción
        • Alternador de lista
        • Arbol visor de tablas
        • Bloc de formularios
        • Casillero
        • Cesta
        • ComboView
        • Control SVG
        • Dispositivo serie
        • Formulario
          • Controles de visualización
            • Texto estático
            • Nombre de campo
            • Visor HTML
            • Dibujo
            • Imagen SVG
            • Caja de grupo
            • Menú arbolado
            • Barra de progreso
            • Reloj
            • Manómetro
            • Termómetro
          • Controles de edición
            • Caja de texto
            • Caja de texto enriquecido
            • Data catcher edit
            • Edición alfabética
            • Edición fecha
            • Edición fecha/hora
            • Edición fórmula
            • Edición hora
            • Edición numérica
            • Edición senda fichero
            • Edición senda directorio
            • Objeto dibujo
          • Controles de entrada
            • Botón
            • Botón de check
            • Botón de radio
            • Calendario
            • ComboBox
            • Deslizador
            • Dial
            • ListBox
            • Rueda
          • Contenedores
            • Área de scroll
            • Caja de formularios
            • Pila de formularios
            • Separador de formularios
            • Splitter
            • Vista de datos
          • Layout
          • Tree widget
          • Controles SVG
          • Extensión de ficha
        • Formulario QML
        • Gráfico
        • Imagen SVG
        • Impresora lógica
        • Informe
          • Editor de informes
          • Agrupamiento
          • Sección
          • Cálculo
        • Informe personalizable
          • Diseñando un informe personalizable básico
          • Diseño avanzado
          • Diseñando un informe personalizable
          • Añadiendo orígenes de datos
          • Añadiendo elementos al informe
          • Características avanzadas
          • Etiquetas
          • Asistente de scripts
          • Impresión de gráficos
          • Opciones html
        • ListView
        • Lista QML
        • Localizador
        • Marco
        • Menú
        • Multivista
        • Protocolo TCP-IP
        • Reemplazo
        • Rejilla
          • Propiedades de columna de rejilla
        • Rejilla avanzada
          • Propiedades de columna de rejilla avanzada
        • Toolbar
        • ViewFlow
        • Sub-objetos de vistas de datos
          • Conexión de evento
          • Drop
          • Inserción
          • Manejador de evento
      • Objetos comunes a proyecto de datos y de aplicación
        • Búsqueda
        • Cola
        • Constante
        • Dibujo
        • Esquema de tablas
        • Fichero adjunto
        • Función
        • Librería externa
        • Lupa
        • Proceso
          • Indice de comandos de instrucción de proceso
          • Comandos de base de datos
            • API
            • Bases de datos externas
            • Búsquedas
            • Campos (grupo de comandos)
            • Cestas
            • Fichas
            • Fichas seleccionadas
            • Listas
            • Tablas
            • Tubos
          • Básicos
            • Controles de flujo
            • Debug
            • Ejecución
            • Salida/retornos
            • Scripts (grupo de comandos)
            • Transacciones (comandos)
            • Variables
          • Comunicación
            • Internet
            • Protocolo TCP
            • Puerto serie
            • SDV
          • Interfaz
            • Acciones (comandos)
            • Control
              • Ejemplo de CSS
            • Diálogos
            • Formularios - comandos
            • Localizadores
            • Objeto - grupo de comandos
            • Ventana principal
            • Vista de datos - comandos
          • Sistema
            • Comandos de Sistema
            • Configuración
            • Directorios
            • Ficheros
        • Tubo de ficha
        • Tubo de lista
        • Variable local
      • Editores
        • Asistente de fórmulas
          • Operadores
          • Funciones estándar
            • Funciones API
            • Funciones básicas
            • Funciones de cadenas
              • Expresiones regulares
            • Funciones científicas
            • Funciones de Cliente-servidor
            • Funciones de color
            • Funciones de códigos
            • Funciones de directorios
            • Funciones de fechas
            • Funciones de ficha en curso
            • Funciones de horas
            • Funciones JSON
            • Funciones de Internet
            • Funciones de juegos de caracteres
              • Codecs
            • Funciones numéricas
            • Funciones de sistema
            • Funciones de tiempo
            • Funciones trigonométricas
          • Funciones de dll
          • Funciones de proceso
          • Funciones de campo
          • Campos
          • Constantes
          • Variables globales
          • Variables locales
          • Variables del sistema
          • Verificador de fórmulas
          • Conversión automática de datos
          • Introducción de datos literales
          • Secuencias de escape en cadenas de caracteres
          • Composición de sendas en fórmulas
          • Operar con datos de tipo fecha, hora y tiempo
        • Editor de imágenes
        • Selector de fuentes
    • Scripts
      • Lenguajes
        • JavaScript
          • Procesos JavaScript
          • Fórmulas JavaScript
          • Clases
            • Funciones globales
            • Objetos
            • VAbstractBrowser
            • VAbstractDataView
            • VAbstractListDataView
            • VAdvandedGridListDataView
            • VAlternatorListDataView
            • VApp
            • VBoundFieldComboBox
            • VBoundFieldEdit
            • VBoundFieldEditBrowser
            • VBoundFieldListBox
            • VByteArray
            • VCheckBox
            • VClipboard
            • VClockWidget
            • VComboBox
            • VComboListDataView
            • VCoverFlowListDataView
            • VCWebView
            • VDataCatcherEdit
            • VDataCatcherEditBrowser
            • VDataView
            • VDataViewDialog
            • VDateEdit
            • VDateEditBrowser
            • VDateTimeEdit
            • VDateTimeEditBrowser
            • VDial
            • VDir
            • VExtension
            • VFile
            • VFileInfo
            • VFilePathEditBrowser
            • VFinder
            • VFont
            • VFormBlockListDataView
            • VFormDataView
            • VFormulaEditBrowser
            • VGaugeWidget
            • VGridListDataView
            • VGroupBox
            • VImage
            • VImageEdit
            • VImageWidget
            • VInstancesList
            • VInstance
            • VInstances
            • VItemRegisterPattern
            • VLabel
            • VLineEdit
            • VLineEditBrowser
            • VListBox
            • VListDataView
            • VLogin
            • VMainWindow
            • VMdiView
            • VMimeData
            • VMultiDataView
            • VNumberSpinBox
            • VNumberSpinBoxBrowser
            • VObjectInfo
            • VObjectInstance
            • VProcess
            • VProgressBar
            • VProjectInfo
            • VPushButton
            • VQmlFormDataView
            • VQmlListDataView
            • VQmlListModel
            • VQuery
            • VRadioButton
            • VRegister
            • VRegisterList
            • VReportListDataView
            • VRequest
            • VResponse
            • VRoot
            • VScreen
            • VScrollArea
            • VServerAdmin
            • VSettings
            • VSlider
            • VSlotListDataView
            • VSolutionInfo
            • VSplitter
            • VSqlDatabase
            • VSSLCertificate
            • VSSLInfo
            • VSSLSessionCipher
            • VStackedWidget
            • VSvgButton
            • VSvgSlideSwitch
            • VSvgToggleSwitch
            • VSvgWidget
            • VSysInfo
            • VTableInfo
            • VTabWidget
            • VTextEdit
            • VTextFIle
            • VThermometerWidget
            • VThumbWheel
            • VTimeEdit
            • VTimeEditBrowser
            • VToolBox
            • VTreeItem
            • VTreeItemRegister
            • VTreeListDataView
            • VTreeMenu
            • VTreeMultiTableListDataView
            • VTreeWidget
            • VUser
            • VUserGroup
            • VUserGroupList
            • VUserList
            • VXmlReader
            • VXmlWriter
            • Widget
            • XMLHttpRequest
        • QML
          • Tipos QML
          • Funciones específicas de QML
    • Depuración
      • Depuración de procesos de Velneo
      • Depuración de procesos JavaScript
      • Monitor de vClient
    • Extensiones de Velneo vDevelop
    • Acceso directo a una solución desde vDevelop
    • Buenas prácticas
      • Buenas prácticas de organización
        • Proyectos
        • Organización de carpetas
        • Proyecto de datos
        • Proyecto de aplicación
      • Buenas prácticas de codificación
        • Identificadores
        • Teclas aceleradoras
        • Documenta
        • Diseña los formularios como si no existiesen los layouts
      • Buenas prácticas de rendimiento
        • Arquitectura
          • Listas de registros
          • Lista de resultados de una búsqueda
          • Las cestas
          • Las variables globales
          • La caché de fichas
          • Programa en cloud
        • Formularios
          • Condiciones de visible y activo
          • Carga de subformularios en pestaña, caja o pila
        • Base de datos
          • Campos
          • Indices
          • Actualizaciones
          • Eventos de tabla o triggers
          • Variables globales y constantes
          • Tablas en memoria vs tablas en disco
          • Optimizar migraciones de datos
          • Búsquedas en el servidor ¿Cuándo y Cómo?
          • Campos fórmula vs campos en disco
          • Indices condicionados vs búsquedas complejas
          • ¿Cuándo usar tablas de extensión?
          • Indices de trozos y palabras
          • ¿Cuándo usar cada tipo de campo alfa?
        • Procesos y funciones y eventos
          • 1º, 2º, 3º y 4º plano ¿Cuándo usar cada uno?
          • Bloqueo blando vs bloqueo duro
          • Pasar información del cliente al servidor
          • ¿Cómo optimizar transacciones grandes?
          • ¿Cómo gestionar las transacciones?
          • Grabaciones optimizadas para el usuario
        • Carga de registros en objetos de lista
          • Rejillas
            • Campos punteros a singular
            • Totales
            • Condiciones de activo, visible y color en columna
            • Campos de tipo objeto
        • Conoce los límites
      • Imágenes
      • Buenas prácticas para el desarrollo en equipo
    • Análisis de bases de datos para aplicaciones de Velneo
      • Un centro de enseñanza
      • Facturas de un cliente
      • Repartos de obras de teatro
      • Galería de arte
      • Gestión de un colegio
      • Instalación de lunas para vehículos
      • Libros y autores
      • Tienda de discos
      • Últimos pedidos de un proveedor
      • Existencias por almacén y precios por cliente
      • Generación de tickets para un quiosco
      • Navegación por facturas
  • Velneo vDevelop Web
  • Velneo vAdmin
    • ¿Qué es Velneo vAdmin?
    • Gestión de usuarios
    • Gestión de aplicaciones
      • Soluciones
      • Instancias
      • Disco
    • Monitorización
      • Lista de comandos
    • Tareas
    • Acceso directo
    • Velneo vAdmin Web
  • Velneo vClient
    • ¿Qué es Velneo vClient?
    • Movilidad
    • Funcionalidades de Velneo vClient
      • Accesos directos y VRL
      • Cambiar idioma
      • Panel de procesos en 2º plano
      • Manejo de rejillas
        • Submenú de filtros
      • Uso de la rejilla avanzada
      • Manejo de cestas
      • Refrescos
      • Caché local
      • Edición de campos enlazados a maestro
      • Edición de campos de tipo fecha
      • Capturar imagen desde una cámara
      • Asignar impresoras lógicas
      • Actualización automática
      • Personalización de la ventana de conexión de Velneo vClient
      • Instalador personalizado de Velneo vClient
      • Ordenación de listas
  • Velneo vServer
    • ¿Qué es Velneo vServer?
    • Instalación y configuración
      • Activación de la licencia
      • Línea de comandos de Velneo vServer
      • Parámetros configurables de Velneo vServer
      • Estructura de directorios
    • Iniciar y detener Velneo vServer
    • Funcionalidades
      • Protocolo VATP
      • Protocolo VATPS
      • Multi-hilo
      • Integridad referencial
      • Refrescos terciarios
      • Sistema transaccional
      • Sistema de bloqueos
      • Tecnología bigkey
      • Hilo de control
    • Mensajes de log de sistema
    • vPacker
  • Velneo vInstallBuilder
    • ¿Qué es Velneo vInstallBuilder?
    • Configurar una instalación
    • Probar una instalación
    • Crear el instalable
    • Accesos directos
  • Velneo vModApache
    • ¿Qué es Velneo vModApache?
    • Instalación y configuración
    • Nomenclatura de objetos en urls
    • Uso de ficheros adjuntos
    • Caché local de Velneo vModApache
  • Velneo vDataClient
    • ¿Qué es Velneo vDataClient?
    • Iniciar Velneo vDataClient
    • Interfaz de Velneo vDataClient
    • Procesos
    • Utilidades
    • Acceso directo a una instancia de datos
  • Velneo vTranslator
    • ¿Qué es Velneo vTranslator?
    • Importación y exportación basada en XLIFF
    • Acceso directo a una solución
  • Velneo ODBC Driver
    • ¿Qué es velneo ODBC Driver?
    • Referencia de comandos SQL
  • Velneo vVersion
    • ¿Qué es Velneo vVersion?
  • Velneo vERP
    • ¿Qué es Velneo vERP?
    • Manual del programador
    • Documentación de la ApiRest
    • Novedades de la versión
  • Velneo vTutor
    • ¿Qué es vTutor?
    • Tutores de objetos básicos
      • Tutor de árboles visores de tablas arboladas
      • Tutor de búsquedas
      • Tutor de cestas
      • Tutor de formularios
      • Tutor de informes
      • Tutor de localizador básico
      • Tutor de marcos
      • Tutor de rejillas
      • Tutor de rejillas avanzadas
    • Tutores de objetos avanzados
      • Tutor de alternadores de lista
      • Tutor de comboview
      • Tutor de drag and drop
      • Tutor de eventos
      • Tutor de tablas de extensión y extensiones de ficha
      • Tutor de grabación de fichas
      • Tutor de gráficos
      • Tutor de impresión de informes
      • Tutor de lupas
      • Tutor de protocolo TCP/IP
      • Tutor de reemplazo
    • Tutores de controles
      • Tutor de botones de menú
      • Tutor de controles SVG
      • Tutor de edición numérica
      • Tutor de visor html dinámico
      • Tutor de vistas de datos de lista
    • Tutores de procesos y manejadores de evento avanzados
      • Tutor de cambio de marco
      • Tutor de comandos de interfaz y acciones
      • Tutor de importación y exportación de ficheros ASCII
      • Tutor de portapapeles
      • Tutor de procesos
      • Tutor de SDV
    • Tutores de scripts
      • QML: hola mundo
      • QML: tutor básico
      • QML: tutor de vistas
      • Tutor de XMLHttpRequest (webServices)
  • Velneo cloud
    • ¿Qué es Velneo Cloud?
    • Panel de control vServer cloud
      • URC
      • vServer
      • Apache
      • SFTP
      • Usuarios
    • Copias de seguridad
    • Velneo cloud API
      • Uso de Velneo cloud API
    • Explorador de archivos cloud sFTP
    • TCP en Velneo cloud
    • Velneo vModApache en cloud
    • SLA
    • Hora de los servidores en el cloud de Velneo
    • ¿Qué puedo hacer si tengo una incidencia en mi servidor cloud?
Con tecnología de GitBook
En esta página
  • Funciones
  • Enumeraciones
  • Documentación de funciones
  • Constructor
  • Funciones de conexión
  • Funciones de estado
  • Funciones de sentencias SQL
  • Funciones de tablas
  • Funciones de campos
  • Funciones de índice primario
  • Ejemplos
  • Ejemplo de lectura de base de datos

¿Te fue útil?

  1. Velneo vDevelop
  2. Scripts
  3. Lenguajes
  4. JavaScript
  5. Clases

VSqlDatabase

Este clase representa la conexión con una base de datos externa.

Dispone de funciones para conexión y obtención de información, además de la ejecución de sentencias SQL.

Requiere importarla previamente a su uso:

importClass ( "VSqlDatabase" );

Funciones

Constructor

Retorno

Función

VSqlDatabase

De conexión

Retorno

Función

void

void

Array

Boolean

De estado

Retorno

Función

Boolean

Boolean

Boolean

De sentencias SQL

Retorno

Función

Boolean

Variant

Variant

Number

String

String

void

Boolean

Boolean

Number

De tablas

Retorno

Función

Array

De campos

Retorno

Función

Number

String

Boolean

Number

String

Number

Number

De índice primario

Retorno

Función

Number

String

String

Enumeraciones

Tipos de campo

  • Invalid = Desconocido

  • Bool = Booleano

  • Int = Entero

  • UInt = Entero sin signo

  • LongLong = LongLong

  • ULongLong = LongLong sin signo

  • Double = Double

  • Char = Char

  • Map = Map

  • List = List

  • String = String

  • StringList = StringList

  • ByteArray = ByteArray

  • Date = Fecha

  • Time = Hora

  • DateTime = Tiempo

  • Pixmap = Mapa de píxeles

  • Image = Imagen

  • Bitmap = Mapa de bits

  • BitArray = BitArray

Tipos de tabla

  • 0x01 = Todas las tablas visibles por el usuario

  • 0x02 = Todas las tablas internas usadas por la base de datos

  • 0x04 = Todas las vistas visibles para el usuario

  • 0xff = Todas las anteriores

Documentación de funciones

Constructor

VSqlDatabase VSqlDatabase()

Construye un conector para acceder a una base de datos externa.

Requiere importarla previamente a su uso:

importClass ( "VSqlDatabase" );

Funciones de conexión

void close()

Cierra la conexión con la base de datos actual. Debemos abrirla de nuevo para continuar trabajando con la base de datos.

void configure( String szPluginDriver, String szNombreDSN, String szOpcionesConexion, String szServidor, int nPuerto )

Configura la conexión con la base de datos externa según los parámetros especificados.

Parámetros:

  • szPluginDriver: cadena entre comillas o comas simples con el identificador del plugin de driver usado.

  • szNombreDSN: nombre o DSN de la base de datos.

  • szOpcionesConexion: opciones de conexión de la base de datos (Opcional)

  • szServidor: servidor de la base de datos a la que nos vamos a conectar (Opcional)

  • nPuerto: puerto usado por la base de datos (Opcional)

Nota:

Si hemos configurado en el DSN el resto de parámetros requeridos para la conexión, no es necesario cumplimentar los parámetros opcionales. En Linux y Mac, el driver en el DSN para ODBC debe ser la senda la propia librería del driver.

No todos los plugins de drivers están disponibles, dependerán del sistema operativo. La función drivers() nos devolverá los plugins disponibles para el ejecutable de entre los siguientes:

"QODBC" Open Database Connectivity (ODBC) 2.0 - Microsoft SQL Server y otros drivers ODBC compatibles

"QODBC3" Open Database Connectivity (ODBC) 3.0 - Microsoft SQL Server y otros drivers ODBC compatibles

"QDB2" IBM DB2 (versión 7.1 y superiores)

"QIBASE" Borland InterBase y Firebird

"QMYSQL" MySQL 5.X

"QMYSQL3" MySQL 3.X

"QOCI" Oracle Call Interface Driver (versiones 9 y superiores)

"QPSQL" PostgreSQL (versiones 7.3 y superiores)

"QPSQL7" PostgreSQL (versiones 6 y 7)

"QSQLITE" SQLite versión 3

"QSQLITE2" SQLite versión 2

En general, el acceso a bases de datos SQLite es el mejor soportado en todas las plataformas, Oracle vía OCI, PosgreSQL y MySQL a través de ODBC o con driver nativo están bastante soportados en Windows y Linux. En cuanto al resto de drivers y sistemas operativos, depende de la calidad de los drivers existentes en cada sistema operativo.

Ejemplos de DSN para ODBC:

Para Windows:

nombreDSN

DSN=nombreDSN

Para Linux y Mac:

Driver={/usr/local/lib/libmyodbc5a.so};Server=www.dominio.com;Port=3306;Database=nombreBaseDatos;Uid=nombreUsuario;Pwd=contraseña;

Opciones de conexión:

ODBC

SQL_ATTR_ACCESS_MODE

SQL_ATTR_LOGIN_TIMEOUT

SQL_ATTR_CONNECTION_TIMEOUT

SQL_ATTR_CURRENT_CATALOG

SQL_ATTR_METADATA_ID

SQL_ATTR_PACKET_SIZE

SQL_ATTR_TRACEFILE

SQL_ATTR_TRACE

SQL_ATTR_CONNECTION_POOLING

SQL_ATTR_ODBC_VERSION

MySQL

CLIENT_COMPRESS

CLIENT_FOUND_ROWS

CLIENT_IGNORE_SPACE

CLIENT_SSL

CLIENT_ODBC

CLIENT_NO_SCHEMA

CLIENT_INTERACTIVE

UNIX_SOCKET

MYSQL_OPT_RECONNECT

MYSQL_OPT_CONNECT_TIMEOUT

MYSQL_OPT_READ_TIMEOUT

MYSQL_OPT_WRITE_TIMEOUT

PostgreSQL

connect_timeout

options

tty

requiressl

service

DB2

SQL_ATTR_ACCESS_MODE

SQL_ATTR_LOGIN_TIMEOUT

OCI

OCI_ATTR_PREFETCH_ROWS

OCI_ATTR_PREFETCH_MEMORY

SQLite

QSQLITE_BUSY_TIMEOUT

QSQLITE_OPEN_READONLY

QSQLITE_OPEN_URI

QSQLITE_ENABLE_SHARED_CACHE

Interbase

ISC_DPB_LC_CTYPE

ISC_DPB_SQL_ROLE_NAME

Ej. de uso:

CLIENT_SSL=1;CLIENT_IGNORE_SPACE=1;

Array drivers()

Devuelve en un array la lista de plugins de driver disponibles para el ejecutable.

Boolean open( String szUsuario, String szContraseña )

Abre la base de datos externa.

Parámetros:

  • szUsuario: nombre del usuario (Opcional)

  • szContraseña: contraseña del usuario (Opcional)

Si hemos configurado en el DSN el resto de parámetros requeridos para la conexión, no es necesario cumplimentar los parámetros opcionales.

Funciones de estado

Boolean isActive()

Devuelve true si la sentencia SQL continúa en ejecución, false si no es así.

Boolean isForwardOnly()

Devuelve true si sólo es posible navegar hacia adelante por los resultados, false si no es así.

Boolean isOpen()

Devuelve true si la conexión con la base de datos ya está establecida, false si no es así.

Funciones de sentencias SQL

Boolean executeSQL( String szSQL, Boolean bForwardOnly )

Ejecuta la sentencia SQL contra la base de datos. Retorna true si ha podido ejecutar la sentencia de forma correcta y false si ha habido algún error.

Parámetros:

  • szSQL: sentencia SQL

  • bForwardOnly: determina que se sólo se avanzará en los resultados

Variant getColumn( int nNumCol )

Devuelve el valor de la columna cuyo index pasamos como parámetro.

Parámetros:

  • nNumCol: index de la columna

Variant getColumn( String szNombreCol )

Devuelve el valor de la columna cuyo nombre pasamos como parámetro.

Parámetros:

  • szNombreCol: nombre de la columna

Number getColumnCount()

Devuelve el número de columnas obtenidas en la sentencia SQL.

String getColumnName( Number nNumCol)

Devuelve el nombre de la columna cuyo index pasamos como parámetro.

Parámetros:

  • nNumCol: index de la columna

String getLastError()

Devuelve el último mensaje de error generado.

void goAfterLastRecord()

Avanza hasta el final de la lista resultante.

Boolean goBeforeFirstRecord()

Vuelve al principio de la lista resultante.

Boolean nextRegister()

Avanza al siguiente registro.

Number numRows()

Retorna el número de filas afectadas por la sentencia SQL que hemos ejecutado, si la base de datos externa lo admite, lo que no sucede para todos los casos.

Funciones de tablas

Array tables( int nTipo )

Devuelve un array con los nombres de las tablas que tiene la base de datos en función del tipo que indicamos como parámetro.

Parámetros:

  • nTipo: ver enum de tipos de tabla

Funciones de campos

Number fieldCount( String szTabla )

Devuelve el número de campos que tiene la tabla cuyo nombre pasamos como parámetro.

Parámetros:

  • szTabla: nombre de la tabla

String fieldDefaultValue( String szTabla, Number nIndex )

Boolean fieldIsAutoValue( String szTabla, Number nIndex )

Devuelve true si el campo tiene valor automático (auto-incremento)

Parámetros:

  • szTabla: nombre de la tabla

  • nIndex: posición de la parte del índice

Number fieldLength( String szTabla, Number nIndex )

Devuelve la longitud del campo.

Parámetros:

  • szTabla: nombre de la tabla

  • nIndex: posición de la parte del índice

En función del driver utilizado, la información que devuelve puede resultar distinta. Por ejemplo, un campo de tipo VARCHAR en MySQL se muestra con la longitud definida en la base de datos a través del driver ODBC, el tamaño de la cadena, pero a través del driver nativo la longitud retorna el número de bytes que ocupa. Por ejemplo: si es latin1 será del mismo tamaño, pero si es utf-8 será del triple, ya que este formato permite cadenas de hasta 3 bytes por carácter.

String fieldName( String szTabla, Number nIndex )

Devuelve el nombre del campo.

Parámetros:

  • szTabla: nombre de la tabla

  • nIndex: posición de la parte del índice

Number fieldPrecision( String szTabla, Number nIndex )

Devuelve la precisión del campo cuando es de tipo numérico.

Parámetros:

  • szTabla: nombre de la tabla

  • nIndex: posición de la parte del índice

Number fieldType( String szTabla, int nIndex )

Devuelve el tipo de campo.

Parámetros:

  • szTabla: nombre de la tabla

  • nIndex: posición de la parte del índice

Ver enum para los tipos de campo.

En función del driver utilizado, la información puede mostrarse distinta. Por ejemplo, un campo de tipo VARCHAR en MySQL se muestra como VSqlDatabase.String a través del driver ODBC, pero a través del driver nativo se muestra como VSqlDatabase.ByteArray cuando el cotejamiento está establecido como UTF-8Bin, por ejemplo.

Funciones de índice primario

Number primaryIndexFieldCount( String szTabla )

Retorna el número de campos que componen el índice primario de la tabla que pasamos como parámetro.

Parámetros:

  • szTabla: nombre de la tabla

String primaryIndexFieldName( String szTabla, int nIndex )

Devuelve el campo de la parte del índice primario de la tabla cuyo nombre pasamos como parámetro.

Parámetros:

  • szTabla: nombre de la tabla

  • nIndex: posición de la parte del índice

String primaryIndexName( String szTabla )

Devuelve el nombre del índice primario de la tabla cuyo nombre pasamos como parámetro.

Parámetros:

  • szTabla: nombre de la tabla

Ejemplos

Ejemplo de lectura de base de datos

importClass( "VSqlDatabase" );

// Importación de datos
function importDB(odbcdriver, odbcdsn, usuario, contraseña, servidor, puerto, opciones )
{
    var bdExterna = new VSqlDatabase();


    if ( bdExterna )
    {
        bdExterna.configure( odbcdriver, odbcdsn, opciones, servidor, puerto );
        var bOpen = bdExterna.open( usuario, contraseña );

        if ( bOpen )
        {
            var aszTablas = bdExterna.tables( 1 ); // Todas las tablas visibles para el usuario

            if ( aszTablas.length )
            {
                // Recorremos las tablas
                for (var i=0 ; i < aszTablas.length ; ++i)
                {    
                    var szTabla = aszTablas[i];

                    bdExterna.executeSQL( "select * from `" + szTabla + "`" );

                    // Obtenemos las cabeceras
                    var aszColumnas = [];
                    var nCampos = bdExterna.fieldCount( szTabla );

                    for (var nColumna=0; nColumna < nCampos; ++nColumna )
                        aszColumnas[nColumna] = bdExterna.getColumnName(nColumna).toUpperCase();

                    //  Contendrá los datos de la tabla
                    var tablaDatos = [];

                    // Recorremos los registros obtenidos en la búsqueda
                    while ( bdExterna.nextRegister() )
                    {    
                        var registro = {}

                        // Asignamos cada campo
                        for ( var nColumna=0; nColumna < nCampos; ++nColumna )
                            registro[aszColumnas[nColumna]] = bdExterna.getColumn( nColumna )

                        // Guardamos la información del registro
                        tablaDatos.push( registro );                    
                    }
                }
            }
            else
            {
                alert( "No se han encontrado tablas. " + bdExterna.getLastError() );
                return false;
            }    

            // Cerramos la conexión
            bdExterna.close();
        }
        else
        {
            alert( "No se ha podido abrir la base de datos. " + bdExterna.getLastError() );
            return false;
        }
    }
    else
    {
        alert( "No se ha podido conectar la base de datos. " + bdExterna.getLastError() );
        return false;
    }

    return true;
}

Última actualización hace 4 años

¿Te fue útil?

()

()

( String szPluginDriver, String szNombreDSN, String szOpcionesConexion, String szServidor, int nPuerto )

()

( String szUsuario, String szContraseña )

()

()

()

( String szSQL, Boolean bForwardOnly )

( int nNumCol )

( String szNombreCol )

()

( Number nNumCol)

()

()

()

()

()

( int nTipo )

( String szTabla )

( String szTabla, Number nIndex )

( String szTabla, Number nIndex )

( String szTabla, Number nIndex )

( String szTabla, Number nIndex )

( String szTabla, Number nIndex )

( String szTabla, int nIndex )

( String szTabla )

( String szTabla, int nIndex )

( String szTabla )

En el caso de una SELECT debemos usar el retorno de la función para saber si debemos seguir recorriendo la lista resultante ya que generalmente no se retorna número de registros afectados.

nextRegister()
VSqlDatabase
close
configure
drivers
open
isActive
isForwardOnly
isOpen
executeSQL
getColumn
getColumn
getColumnCount
getColumnName
getLastError
goAfterLastRecord
goBeforeFirstRecord
nextRegister
numRows
tables
fieldCount
fieldDefaultValue
fieldIsAutoValue
fieldLength
fieldName
fieldPrecision
fieldType
primaryIndexFieldCount
primaryIndexFieldName
primaryIndexName