Код преобразован в число
Сохраните точный код и проверьте ведущие нули при загрузке.
Подробные практические руководства
Описать уровень строки, столбцы, типы, единицы, пропуски и ключи до расчётов или соединений.
Обновление :

Иллюстрация, созданная ИИ
Заголовка столбца недостаточно. Словарь связывает поля с определениями, допустимыми значениями и версией схемы. Различайте набор и его представления, например CSV и API.
Опишите объект, территорию и период: компания-год отличается от подразделения-месяца. Укажите ожидаемый уникальный ключ и связи таблиц.
Для столбца запишите имя, определение, логический тип, формат, единицу, коды, допустимость пропуска и источник. ID с ведущими нулями храните как текст.
Проверьте уникальность, допустимые значения и обязательные поля в файле. Пустая строка, неприменимо и ноль различаются. Датируйте изменения определений, кодов и типов.
Практикум чтения данных
Контракт DEMO задаёт одну строку на дело. Придуманные правила не описывают реальный реестр.
Вымышленные данные и записи для обучения: результаты не получены запросами к действующим сервисам.
Формат — JSON: record_id является строкой из четырёх цифр, state принимает OPEN или CLOSED, amount — десятичное число либо null. record_id должен быть уникальным. Регистр и типы входят в контракт.
Если таблица шире экрана, прокрутите её по горизонтали; стрелки работают, когда область в фокусе.
| Поле или правило | Проверяемое значение | Прочтение контракта | Действие |
|---|---|---|---|
| record_id: текст | "0042"; число 42 | Строка допустима; число нарушает тип | Отклонить 42, не придумывая нули. |
| state: точный код | OPEN; open | OPEN допустим; open вне области значений | Не менять регистр без согласованного правила. |
| amount: число или null | 12.5; "12.5"; null; "" | Число и null допустимы; обе строки отклоняются | null означает неизвестное; не подставлять ноль. |
| Уникальность record_id | Две строки с "0042" | Ключ повторяется даже при разных суммах | Не утверждать результат; запросить верный уровень записи. |
Раскройте каждый вариант и сравните разбор. Дополнительные проверки могут оставаться необходимыми.
Нет. Так стираются аномалии и добавляются отсутствующие в контракте предположения.
Да. Разделить ошибки типов, неверные коды и повтор ключа. Разрешить по документации или с производителем.
Нет. Этот JSON-контракт различает их. В CSV может быть другое отдельно описанное правило.
Контракт: DEMO, строка на дело, JSON record_id: текст из четырёх цифр, уникальный ключ state: OPEN или CLOSED, точный регистр amount: десятичное число или null; null=неизвестно Нарушения: тип, код, пустая строка, повтор ключа Решение: исходные данные сохранены, результат не утверждён
Это краткая запись учебного контракта, не полная исполняемая схема. Файлы пользователя не проверяются.
Сохраните точный код и проверьте ведущие нули при загрузке.
Уточните валюту, масштаб и период до суммирования; величина не определяет единицу.
Разбор фрагмента
В этом вымышленном примере строка описывает площадку за один год. Словарь ниже задаёт правила чтения; в данных намеренно оставлена ошибка.
Вымышленное упражнение: идентификаторы, значения и даты иллюстрируют проверку. Это не ответ, полученный в реальном времени.
Пара site_id и year должна быть уникальной. Одна площадка может встречаться за разные годы.
site_id — текстовый идентификатор из трёх цифр. amount_kEUR — годовая сумма в тысячах евро; пустая ячейка означает отсутствие сведений.
Сравните пары ключей, сохраните ведущие нули и различайте нулевую и неизвестную сумму до агрегирования.
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); uniqueНет. Сначала выясните причину дублирования ключа у производителя и определите обработку пропусков. Сумма только известных значений скроет неизвестную строку и может дважды учесть одну площадку за один год. Сохраните исходные строки и зафиксируйте решение.
Официальные источники : W3C — Model for Tabular Data and Metadata on the Web
Упражнение с разбором
Вымышленный пример: значения и документы служат для изучения метода и не описывают реальную организацию.
Производитель указывает amount в тысячах евро с округлением до десятых. Внутренний словарь сообщает лишь «число»; исходные суммы не даны.
Если таблица шире экрана, прокрутите её по горизонтали; стрелки работают, когда область в фокусе.
| Строка | amount |
|---|---|
| A | 1.2 |
| B | 2.5 |
Сумма опубликованных значений — 3.7 тысячи евро, или 3 700 евро. Запись 3.70 не добавляет точности. Указать единицу и пояснить, что сумма использует округлённые, а не известные точные суммы.
При появлении неокруглённых сумм рассчитать их отдельно и обозначить версию. Добавить пропуск в вымышленный набор: amount=0 означает известную нулевую сумму, а неизвестная ячейка суммы не задаёт. Описать код пропуска и проверить, что импорт не превращает его молча в ноль перед агрегированием.
Сохранить определение, единицу, масштаб, точность, коды пропусков и верный пример.
Документальная ссылка : W3C — CSV on the Web: A Primer · Дата обращения
ДОКУМЕНТИРОВАННЫЕ ОРИЕНТИРЫ
RFC 6901 адресует значение в JSON, не является JSONPath или изменением. Читатель использует вымышленный учебный документ, не наблюдения, различая значение, отсутствующий путь и неверный синтаксис.
| Ориентир | Значение или форма | Что обозначает |
|---|---|---|
| "" | Root value | Пустая строка выбирает весь документ, не отсутствие результата. |
| / | Empty member name | Один слеш выбирает свойство с пустым именем, если оно есть, не корень. |
| ~1 | / inside member name | Слеш внутри имени кодируется ~1. Ключ a/b отличается от a с вложенным b. |
| ~0 | ~ inside member name | Тильда кодируется ~0. Декодируйте ~1 до ~0: ~01 означает буквальное ~1, не слеш. |
| /items/0 | Zero-based array index | Первый индекс ноль; неотрицательное целое без лишних начальных нулей. |
| /items/01 | Invalid array index | 01 недопустим как индекс массива, но допустим как точное имя свойства. |
| /items/- | No existing array member | Дефис указывает за последний элемент, не существующий при чтении; это не автоматическое добавление. |
| #/a~1b | URI-fragment form | URI-фрагмент начинается # и требует URI-декодирования. Процент там кодируется; обычный текст так не декодируется. |
Документ вымышленный: числа не наблюдения. Локальное чтение без запросов и изменений.
{
"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"
}Исходный пример: /items/0/count даёт 0; /items/0/note — null; /items/1/note — пустую строку; / — false.
Значение найдено · число
0Имена точные: пробелы не удаляются, акценты не нормализуются. Читатель ничего не добавляет и не обрабатывает JSONPath.
Имена сравниваются точно без исправления акцентов, регистра и пробелов. Сохраняйте null, false, ноль и пустую строку. Верный синтаксис может не найти значения; не создавайте ноль. Ключи не переводятся.
Свойство существует с явным null. Отсутствующее свойство не разрешается; для объединения и таблиц это разные случаи.
Документация просмотрена .
ДОКУМЕНТИРОВАННЫЕ ОРИЕНТИРЫ
RFC 8259 задаёт синтаксис, не бесконечную точность. Длинные числа меняются при чтении. Примеры учебные, не выданные идентификаторы.
| Ориентир | Значение или форма | Что обозначает |
|---|---|---|
| Integer interoperability | −9007199254740991 … 9007199254740991 | Совместимый диапазон целых для binary64, не синтаксический предел JSON. |
| Beyond 2^53 − 1 | binary64 · 2^53 + 1 | Вне диапазона некоторые целые точны, но соседние различимы не всегда. |
| "00123" / 123 | "00123" ≠ 123 | Строка "00123" хранит нули, число 123 нет; код не обязан быть количеством. |
| NaN / Infinity | JSON: ✗ | NaN и Infinity не числовые литералы JSON. |
| Duplicate object names | SHOULD | Имена SHOULD быть уникальны: читатели оставляют последнее, отклоняют или показывают все пары. |
| Network exchange | UTF-8 · RFC 8259 §8.1 | Обмен вне закрытой среды требует UTF-8; округление это не устраняет. |
Задайте типы до чтения. Строка из округлённого числа не вернёт цифры. Ищите дубликаты до перезаписи и храните источник.
Нет: числа могут округлиться, ключи перезаписаться. Проверяйте исходное представление.
Документация просмотрена .
Нет: пример показывает значение, определение задаёт допустимый диапазон.
Опишите общую схему и различия представлений: имена, форматы, правила null.
Поиск документации и сохранение неопределенности. Обсервативные ценности могут помочь сформулировать гипотезу, но не всегда достаточно для подтверждения смысла или соответствующих операций.
ИНСТРУМЕНТЫ / РЕЕСТРЫ
Проверьте уникальность, допустимые значения и обязательные поля в файле. Пустая строка, неприменимо и ноль различаются. Датируйте изменения определений, кодов и типов.
ДОКУМЕНТИРОВАННЫЕ ОРИЕНТИРЫ
Поле id не автоматически первичный ключ. Важны действующие ограничения. Правила PostgreSQL 18; другие СУБД иначе трактуют NULL.
| Ориентир | Значение или форма | Что обозначает |
|---|---|---|
| PRIMARY KEY (a) | Уникально и не NULL | Простой первичный ключ уникален и не NULL, но не доказывает верность или стабильность. |
| UNIQUE (a) | NULL различны по умолчанию | UNIQUE по умолчанию допускает несколько NULL; это не полнота. |
| UNIQUE NULLS NOT DISTINCT (a) | Не более одного NULL в столбце | NULLS NOT DISTINCT оставляет максимум один NULL в a, но допускает отсутствие. |
| PRIMARY KEY (a, b) | Уникальная пара · компоненты не NULL | Составной ключ уникален парой, не каждым полем; оба не NULL. |
| FOREIGN KEY · MATCH SIMPLE | Любой NULL может освободить от ссылки | MATCH SIMPLE может освободить от ссылки при любом NULL компонента. |
| FOREIGN KEY · MATCH FULL | Только все NULL освобождают | MATCH FULL освобождает только при всех NULL; смесь запрещена. Обязательности нужен NOT NULL. |
| CHECK (x > 0) | Истина или неизвестно проходит | CHECK пропускает истинное или неизвестное; отсутствующий x может пройти x > 0. |
Массив JSON из 0–50 строк; в каждой от 1 до 3 компонентов, число одинаково. Компонент — строка до 64 кодовых точек или null. Ширина соединяемых таблиц должна совпадать. Не более 20 000 знаков JSON в поле. Пустая строка остаётся значением, отличным от null.
Учебные примеры и локальный расчёт без запросов к базе и передачи ввода. Сравнение учитывает регистр без удаления пробелов, нормализации Unicode и преобразования типов. Результат описывает только введённые строки и не удостоверяет ограничения реальной базы.
Учебный пример рассчитан; измените ввод и проверьте его.
| Набор ключей | UNIQUE | UNIQUE NULLS NOT DISTINCT | PRIMARY KEY |
|---|---|---|---|
| [["001"],["002"]] | Совместимо с этим правилом | Совместимо с этим правилом | Совместимо с этим правилом |
| [["001"],["001"]] | Несовместимо с этим правилом | Несовместимо с этим правилом | Несовместимо с этим правилом |
| [[null]] | Совместимо с этим правилом | Совместимо с этим правилом | Несовместимо с этим правилом |
| [[null],[null]] | Совместимо с этим правилом | Несовместимо с этим правилом | Несовместимо с этим правилом |
| [["FR",null],["FR",null]] | Совместимо с этим правилом | Несовместимо с этим правилом | Несовместимо с этим правилом |
| [["FR","001"],["FI","001"]] | Совместимо с этим правилом | Совместимо с этим правилом | Совместимо с этим правилом |
{
"keys": [
[
null
],
[
null
]
]
}Внешний ключ не делает связь один-к-одному; детей может быть много. Храните столбцы и политику NULL. CSV не переносит гарантии автоматически.
Нет: гранулярность, объединённые годы и потерянные компоненты могут отличаться. Сначала проверьте.
Документация просмотрена .
ПОДРОБНЕЕ / ПРАКТИКА
Таблица содержит короткие названия колонн и сложное толкование кодов. Словарь должен дать понятие, которое можно использовать, и сохранить неразрешенные двусмысленности.
Обновлено .
Документируйте имя, тип, единицу, режимы, недостающие значения и примеры. Идентифицировать ключи и поля, значение которых зависит от другой переменной.
Цифровый тип не означает, что можно добавлять ценности. Код может представлять категорию, идентификатор или отсутствующую ценность.
Речник связывает оригинальное поле, определение, правила чтения и документальный источник. Ипотезы отделены от подтвержденных определений.