Documentaciónestructura(db, nombre_tabla)

estructura(db,nombretabla)\texttt{estructura}(db, nombre_{tabla})

Nombre

estructura - Devuelve la estructura de columnas de una tabla SQLite.

Sinopsis

tabla = sqlite.estructura(db, nombre_tabla)

Descripcion

Consulta PRAGMA table_info(...) sobre la tabla indicada y devuelve una TABLA BLOX con una fila por columna.

La salida suele incluir campos como:

  • cid : posicion de la columna
  • name : nombre de la columna
  • type : tipo SQL declarado
  • notnull : si la columna exige valor
  • dflt_value : valor por defecto
  • pk : si forma parte de la clave primaria

Es util para:

  • ver nombres y tipos de columnas
  • detectar claves primarias
  • inspeccionar restricciones basicas de una tabla

Comportamiento

  • Se aplica sobre una tabla concreta.
  • Devuelve metadata estructural orientada a columnas.
  • Si la tabla no existe, retorna una tabla vacia o sin filas utiles.

Funciones API relacionadas

  • sqlite.esquema()
  • sqlite.esquema_tabla()
  • sqlite.listar_tablas()
  • sqlite.imprimir_estructura()
  • sqlite.indices()
  • sqlite.imprimir_indices()

Parámetros

ParámetroTipoDescripción
dbSQLITEHandle de conexion SQLite abierto.
nombre_tablaSTRINGNombre de la tabla a inspeccionar.

Valor de retorno

TABLA - TABLA con una fila por columna y campos como cid, name, type, notnull, dflt_value y pk.

Ejemplo

ejemplo.blox



INCLUIR "sqlite.api"
INCLUIR "docs.api"
INCLUIR "tablas.api"

FUNCION PRINCIPAL
INICIO

    SQLITE db
    TABLA  t

    db = sqlite.abrir("documentacion_blox.db")
        t = sqlite.estructura(db, "modulos")
        tablas.imprimir(t)
    sqlite.cerrar(db)

FINAL