Saltar al contenido principal

SQLite

Traducción Beta No Oficial

Esta página fue traducida por PageTurner AI (beta). No está respaldada oficialmente por el proyecto. ¿Encontraste un error? Reportar problema →

Instalación​

  • para Better SQLite:
npm install better-sqlite3
  • para sql.js:
npm install sql.js

Opciones de Data Source​

Consulta Opciones de Origen de Datos para ver las opciones comunes de origen de datos.

Opciones de origen de datos para better-sqlite3​

  • database - Ruta de la base de datos. Por ejemplo, "mydb.sqlite".

  • enableWAL - Habilita el modo WAL (valor predeterminado: false). Consulta Modo WAL de SQLite.

  • fileMustExist - Si la base de datos no existe, se lanzará un error en lugar de crear un nuevo archivo. No afecta a conexiones en memoria o de solo lectura (valor predeterminado: false).

  • key - Clave de cifrado para SQLCipher.

  • nativeBinding - Ruta relativa o absoluta al complemento nativo (better_sqlite3.node).

  • prepareDatabase - Función que se ejecuta antes de utilizar la base de datos en TypeORM. Aquí puedes acceder al objeto Database original de better-sqlite3.

  • readonly - Abre la conexión de la base de datos en modo de solo lectura (valor predeterminado: false).

  • statementCacheSize - Tamaño de la caché para las sentencias SQLite con el fin de acelerar las consultas (valor predeterminado: 100).

  • timeout - Número de milisegundos que se espera al ejecutar consultas en una base de datos bloqueada, antes de lanzar un error SQLITE_BUSY (valor predeterminado: 5000).

  • verbose - Función que se invoca con cada cadena SQL ejecutada por la conexión de la base de datos.

Opciones de origen de datos para sql.js​

  • database: Base de datos en formato UInt8Array que debe importarse.

  • sqlJsConfig: Configuración opcional de inicialización para sql.js.

  • autoSave: Habilita el guardado automático de cambios en la base de datos, requiere location o autoSaveCallback. Cuando es true, cada cambio se guarda en el sistema de archivos (Node.js) o en localStorage/indexedDB (navegador) si se especifica location, o se invoca autoSaveCallback en otros casos.

  • autoSaveCallback: Función que se invoca cuando se realizan cambios en la base de datos y autoSave está activado. Recibe un UInt8Array que representa la base de datos.

  • location: Ubicación del archivo para cargar y guardar la base de datos.

  • useLocalForage: Habilita el uso de la biblioteca localforage para guardar y cargar la base de datos asincrónicamente desde indexedDB, en lugar de usar los métodos síncronos de almacenamiento local en entornos de navegador. Debes añadir el módulo node de localforage a tu proyecto e importar localforage.js en tu página.

Opciones de origen de datos para capacitor​

  • database - Nombre de la base de datos (capacitor-sqlite añadirá el sufijo SQLite.db)

  • driver - Instancia de capacitor-sqlite. Por ejemplo, new SQLiteConnection(CapacitorSQLite).

  • mode - Configura el modo de cifrado de la base de datos: "no-encryption" | "encryption" | "secret" | "newsecret"

  • version - Versión de la base de datos

  • journalMode - Modo de journal de SQLite (opcional)

Opciones de origen de datos para cordova​

  • database - Nombre de la base de datos

  • location - Ubicación para guardar la base de datos. Consulta cordova-sqlite-storage para ver las opciones.

Opciones de origen de datos para expo​

  • database - Nombre de la base de datos. Por ejemplo, "mydb".

  • driver - Módulo SQLite de Expo. Por ejemplo, require('expo-sqlite').

Opciones de origen de datos para nativescript​

  • database - Nombre de la base de datos

Opciones de origen de datos para react-native​

  • database - Nombre de la base de datos

  • location - Ubicación para guardar la base de datos. Consulta react-native-sqlite-storage para ver las opciones.

Tipos de Columna​

int, int2, int8, integer, tinyint, smallint, mediumint, bigint, decimal, numeric, float, double, real, double precision, datetime, varying character, character, native character, varchar, nchar, nvarchar2, unsigned big int, boolean, blob, text, clob, date, json, jsonb

TypeORM admite tanto los tipos json como jsonb en SQLite:

  • json se almacena como TEXT.

  • jsonb se almacena en el formato binario JSON de SQLite. TypeORM envuelve automáticamente los valores con la función jsonb() durante la persistencia y con la función json() durante la recuperación para un soporte transparente y un mejor rendimiento.

El soporte para JSONB requiere SQLite 3.45.0 o superior. Cuando se utiliza el tipo de columna jsonb, TypeORM usará el tipo jsonb en tu esquema de base de datos, que SQLite maneja internamente como un BLOB binario.