Código convertido a número
Conserve el código exacto y pruebe que la carga mantiene ceros iniciales.
Guías prácticas detalladas
Describir granularidad, columnas, tipos, unidades, valores ausentes y claves antes de calcular o unir.
Actualización :

Ilustración generada por IA
Un encabezado no basta para entender un archivo. El diccionario relaciona campos, definiciones, dominios y versiones. Distinga conjunto y distribuciones, como CSV y API.
Defina objeto, territorio y periodo: empresa-año difiere de establecimiento-mes. Indique clave única esperada y relaciones con tablas.
Para cada columna: nombre exacto, definición, tipo, formato, unidad, códigos, nulabilidad y origen. Guarde IDs con ceros iniciales como texto.
Pruebe unicidad, dominios y campos requeridos en el archivo real. Vacío, no aplicable y cero difieren. Feche cambios de definición, código o tipo.
Taller de lectura
El contrato DEMO define una fila por expediente. Sus reglas inventadas no describen ningún registro real.
Datos y registros ficticios para aprender: ninguno de estos resultados procede de una consulta en directo.
La distribución es JSON: record_id es una cadena de cuatro dígitos, state es OPEN o CLOSED y amount es decimal o null. record_id debe ser único. Mayúsculas y tipos son parte del contrato.
Si la tabla supera la pantalla, desplácela horizontalmente; las flechas funcionan cuando la zona tiene el foco.
| Campo o regla | Valor probado | Lectura contractual | Acción |
|---|---|---|---|
| record_id: texto | "0042"; número 42 | La cadena se admite; el número incumple el tipo | Rechazar 42 sin inventar ceros. |
| state: código exacto | OPEN; open | OPEN se admite; open queda fuera del dominio | No cambiar mayúsculas sin una regla validada. |
| amount: número o null | 12.5; "12.5"; null; "" | Número y null admitidos; ambas cadenas rechazadas | null significa desconocido; nunca cero por defecto. |
| record_id único | Dos filas con "0042" | La clave se repite aunque cambien los importes | No validar la salida y pedir el nivel correcto de observación. |
Abra cada propuesta para comparar su diagnóstico. Pueden seguir siendo necesarios otros controles.
No. Borra anomalías e introduce hipótesis ausentes del contrato.
Sí. Separar errores de tipo, códigos inválidos y claves repetidas. Resolver con documentación o productor.
No. Este contrato JSON los distingue. Un CSV puede tener otra regla, documentada por separado.
Contrato: DEMO, una fila por expediente, JSON record_id: texto de cuatro dígitos, clave única state: OPEN o CLOSED, mayúsculas exactas amount: número decimal o null; null=desconocido Infracciones: tipo, código, cadena vacía, clave repetida Decisión: datos brutos conservados, salida sin validar
La notación resume un contrato didáctico, no un esquema ejecutable completo. No se valida ningún archivo del usuario.
Conserve el código exacto y pruebe que la carga mantiene ceros iniciales.
Identifique moneda, escala y periodo antes de sumar; no infiera unidad de la magnitud.
Lectura guiada de un fragmento
En este ejemplo ficticio, cada fila describe un centro para un año. El diccionario siguiente fija las reglas de lectura; los datos contienen una anomalía deliberada.
Ejercicio ficticio: identificadores, valores y fechas ilustran el control. El fragmento no es una respuesta recogida en directo.
La pareja site_id y year debe ser única. Un centro puede aparecer en varios años.
site_id es un identificador de texto de tres cifras. amount_kEUR es un importe anual en miles de euros; una celda vacía significa no informado.
Compare las parejas de claves, conserve los ceros iniciales y distinga importe cero e importe desconocido antes de agregar.
site_id,year,amount_kEUR
007,2024,
007,2025,0
007,2025,12.5
site_id : string; pattern = ^[0-9]{3}$; required
year : integer; required
amount_kEUR : decimal; unit = 1000 EUR; empty = unknown
key : (site_id, year); uniqueNo. Primero resuelva la clave duplicada con el productor y defina cómo tratar los valores ausentes. Sumar solo los valores conocidos ocultaría la fila desconocida y podría contar dos veces el mismo centro-año. Conserve las filas originales y documente la decisión.
Referencias oficiales : W3C — Model for Tabular Data and Metadata on the Web
Ejercicio resuelto
Ejemplo ficticio: los valores y documentos permiten aprender el método y no describen una organización real.
El productor define amount en miles de euros, redondeados a una décima. El diccionario interno solo dice «número»; no se facilitan importes brutos.
Si la tabla supera la pantalla, desplácela horizontalmente; las flechas funcionan cuando la zona tiene el foco.
| Fila | amount |
|---|---|
| A | 1.2 |
| B | 2.5 |
La suma publicada es 3.7 miles de euros, o 3 700 euros. Escribir 3.70 no aporta precisión. Definir la unidad y explicar que se suman valores redondeados, no importes exactos conocidos.
Si hay importes brutos sin redondear, calcularlos por separado e identificar su versión. Añadir una ausencia al juego ficticio: amount=0 es un importe cero conocido; una celda declarada desconocida no aporta importe. Documentar el código de ausencia y comprobar que la importación no lo convierta silenciosamente en cero antes de agregar.
Guardar definición, unidad, escala, precisión, ausencias y ejemplo válido.
Referencia documental : W3C — CSV on the Web: A Primer · Consultada el
REFERENCIAS DOCUMENTADAS
RFC 6901 dirige a un valor JSON; no es JSONPath ni modificación. El lector usa un documento didáctico inventado, no observaciones, y distingue valor, camino ausente y sintaxis inválida.
| Referencia | Valor o forma | Qué identifica |
|---|---|---|
| "" | Root value | La cadena vacía selecciona todo el documento; no significa sin resultados. |
| / | Empty member name | Un slash selecciona la propiedad de nombre vacío si existe, no la raíz. |
| ~1 | / inside member name | Codifique slash interno como ~1. La propiedad a/b difiere de a que contiene b. |
| ~0 | ~ inside member name | Tilde como ~0. Decodifique ~1 antes de ~0: ~01 significa ~1 literal, no slash. |
| /items/0 | Zero-based array index | El primer índice es cero; entero no negativo sin ceros iniciales extra. |
| /items/01 | Invalid array index | 01 no es índice válido pero puede ser clave exacta de objeto; importa el tipo. |
| /items/- | No existing array member | Guion apunta después del último elemento, inexistente para lectura; no añade automáticamente. |
| #/a~1b | URI-fragment form | Fragmento URI empieza por # y decodifica URI. Codifique porcentaje literal allí; no decodifique la forma texto como URI. |
Documento inventado: las cifras no son observaciones. Lectura local sin peticiones ni modificaciones.
{
"items": [
{
"id": "A",
"count": 0,
"note": null
},
{
"id": "B",
"count": 3,
"note": ""
}
],
"a/b": {
"m~n": true
},
"": false,
"01": "code",
"é": "accent",
"~1": "literal",
"c%d": "percent"
}Ejemplo inicial: /items/0/count da 0; /items/0/note da null; /items/1/note da cadena vacía; / da false.
Valor encontrado · número
0Nombres exactos: no se eliminan espacios ni se normalizan acentos. No añade elementos ni procesa JSONPath.
Compare nombres exactos sin corregir acentos, mayúsculas o espacios. Preserve null, false, cero y cadena vacía. Sintaxis válida puede no resolver nada; no invente cero. Claves no cambian con el idioma.
La propiedad existe con null explícito. Una propiedad ausente no resuelve valor; son situaciones distintas para uniones y conversiones.
Documentación consultada el .
REFERENCIAS DOCUMENTADAS
RFC 8259 fija sintaxis, no precisión ilimitada. Números largos pueden cambiar al leerlos. Formas educativas, no identificadores asignados.
| Referencia | Valor o forma | Qué identifica |
|---|---|---|
| Integer interoperability | −9007199254740991 … 9007199254740991 | Intervalo entero interoperable con binary64, no límite sintáctico de JSON. |
| Beyond 2^53 − 1 | binary64 · 2^53 + 1 | Fuera, algunos enteros son exactos pero no todos los consecutivos se distinguen. |
| "00123" / 123 | "00123" ≠ 123 | La cadena "00123" conserva ceros, el número 123 no; código no implica cantidad. |
| NaN / Infinity | JSON: ✗ | NaN e Infinity no son literales numéricos JSON. |
| Duplicate object names | SHOULD | Nombres SHOULD únicos: lectores conservan último, rechazan o muestran todas las parejas. |
| Network exchange | UTF-8 · RFC 8259 §8.1 | Intercambio fuera de ecosistema cerrado requiere UTF-8; no evita redondeo. |
Fije tipos antes de leer. Convertir un número redondeado a texto no recupera cifras. Detecte duplicados antes de sobrescritura y guarde fuente.
No: puede redondear y sobrescribir claves. Valide también la representación original.
Documentación consultada el .
No: un ejemplo muestra un valor; la definición fija todos los admisibles.
Documente esquema común y diferencias: nombres, formatos y reglas de nulos.
Buscar la documentación y mantener la incertidumbre. Los valores observados pueden ayudar a formular una hipótesis, pero no siempre son suficientes para confirmar el sentido ni las operaciones pertinentes.
HERRAMIENTAS / REGISTROS
Pruebe unicidad, dominios y campos requeridos en el archivo real. Vacío, no aplicable y cero difieren. Feche cambios de definición, código o tipo.
REFERENCIAS DOCUMENTADAS
Un campo id no es automáticamente clave primaria. Importan restricciones efectivas. Reglas PostgreSQL 18; otros sistemas tratan NULL de otra manera.
| Referencia | Valor o forma | Qué identifica |
|---|---|---|
| PRIMARY KEY (a) | Único y no nulo | Clave simple: única y no nula, no prueba exactitud real o estabilidad. |
| UNIQUE (a) | NULL distintos por defecto | UNIQUE permite varios NULL por defecto; no garantiza completitud. |
| UNIQUE NULLS NOT DISTINCT (a) | Como máximo un NULL en esta columna | NULLS NOT DISTINCT admite como máximo un NULL en columna a, pero permite una ausencia. |
| PRIMARY KEY (a, b) | Par único · componentes no nulos | La clave compuesta hace único el par, no cada componente; ambos no nulos. |
| FOREIGN KEY · MATCH SIMPLE | Cualquier NULL puede eximir referencia | MATCH SIMPLE puede eximir referencia con cualquier componente NULL. |
| FOREIGN KEY · MATCH FULL | Solo todos NULL eximen referencia | MATCH FULL solo exime todos NULL; mezcla falla. Use NOT NULL para referencia obligatoria. |
| CHECK (x > 0) | Verdadero o desconocido pasa | CHECK acepta verdadero o desconocido; x ausente puede pasar x > 0. |
Array JSON de 0–50 filas; cada fila tiene 1–3 componentes, siempre la misma cantidad. Cada componente es una cadena de hasta 64 puntos de código o null. Ambas tablas unidas deben tener igual anchura. Máximo 20.000 caracteres JSON por campo. Una cadena vacía es un valor distinto de null.
Ejemplos didácticos y cálculo local sin consultar una base ni transmitir entradas. Comparación sensible a mayúsculas sin recortar espacios, normalizar Unicode ni convertir tipos. Los resultados describen solo las filas introducidas y no certifican restricciones de una base real.
Ejemplo didáctico calculado; modifique las entradas y examínelas.
| Conjunto de claves | UNIQUE | UNIQUE NULLS NOT DISTINCT | PRIMARY KEY |
|---|---|---|---|
| [["001"],["002"]] | Compatible con esta política | Compatible con esta política | Compatible con esta política |
| [["001"],["001"]] | Incompatible con esta política | Incompatible con esta política | Incompatible con esta política |
| [[null]] | Compatible con esta política | Compatible con esta política | Incompatible con esta política |
| [[null],[null]] | Compatible con esta política | Incompatible con esta política | Incompatible con esta política |
| [["FR",null],["FR",null]] | Compatible con esta política | Incompatible con esta política | Incompatible con esta política |
| [["FR","001"],["FI","001"]] | Compatible con esta política | Compatible con esta política | Compatible con esta política |
{
"keys": [
[
null
],
[
null
]
]
}Una clave externa no impone uno a uno; varios hijos pueden referir padre. Registre columnas y política NULL. CSV no conserva restricciones automáticamente.
No: grano, años concatenados o componentes perdidos pueden cambiar. Revise antes de borrar.
Documentación consultada el .
PROFUNDIZACIÓN / PRÁCTICA
Una tabla contiene nombres de columnas cortos y códigos difíciles de interpretar. El diccionario debe dar una definición usable y conservar las ambiguidades no resueltas.
Actualizado el .
Documentar nombre, tipo, unidad, modalidades, valores faltantes y ejemplos. Identificar las claves y los campos cuyo sentido depende de otra variable.
Un tipo digital no significa que se puedan añadir valores. Un código puede representar una categoría, identificador o un valor ausente.
El diccionario conecta campo original, definición, reglas de lectura y fuente documental. Las hipótesis están separadas de las definiciones confirmadas.