Ensure primary keys created via the JSON API are NOT NULL

[PranavMishra28]

What was broken

The table-create JSON API (/db/-/create) builds its own CREATE TABLE (the explicit-columns path in TableCreateView.create_table) without marking primary key columns NOT NULL. So a text or composite primary key is created nullable:

POST /data/-/create
{"table": "t", "columns": [{"name": "code", "type": "text"}], "pk": "code"}

→ CREATE TABLE "t" ("code" TEXT PRIMARY KEY, ...) — code can be NULL.

Why it matters

SQLite permits a NULL value in any primary key that isn't a single-column INTEGER PRIMARY KEY (and lets multiple rows share the NULL key). As #2805 shows, such rows can't be viewed, edited or deleted through Datasette — the row URL resolves to None/"". #2807 asks to "stem the bleeding" by disallowing null primary keys for tables created via the JSON API.

What the fix does

In the explicit-columns create path — the one Simon described as "any time we run our own CREATE TABLE we set not null on any primary key we create" — primary key columns are added to the not_null set passed to table.create(). A single-column INTEGER PRIMARY KEY is skipped because it aliases the rowid and can never be NULL, so no redundant constraint is emitted (and the common id schema is unchanged).

Result: "code" TEXT PRIMARY KEY NOT NULL; composite keys get NOT NULL on every key column.

What it deliberately does not change

• Single-column INTEGER PRIMARY KEY output is untouched (still INTEGER PRIMARY KEY), so existing schemas/tests/docs are unaffected.
• The rows/insert_all inference path is not changed here. That path can also create a nullable text pk, but because its column types are inferred rather than declared, the single-integer-pk (rowid) exception can't be applied reliably in the same way. Happy to follow up on that path if you'd like it covered too — hence Refs #2807 rather than Fixes.
• No dependency, API-shape, or validation changes.

Testing

• New test_create_table_primary_keys_are_not_null covers a single text pk and a composite pk (schema + pragma_table_info notnull), and asserts non-pk columns stay nullable.
• tests/test_api_write.py (148 passed), plus tests/test_schema_endpoints.py and tests/test_api.py, all green; black --check and ruff check clean.

Refs #2807

Developed with Claude Code; reviewed and tested by Pranav before marking ready for review.

[PranavMishra28]

@simonw lemme know when you can throw some eyes here or require any other changes

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 3956e63650

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".