Skip to content

docs(clients): document owned_by, the owner of auto-created tables - #652

Open
glasstiger wants to merge 3 commits into
mainfrom
ia_qwp_owned_by
Open

glasstiger wants to merge 3 commits into
mainfrom
ia_qwp_owned_by

Conversation

@glasstiger

@glasstiger glasstiger commented Nov 19, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Documents the owned_by connect-string key: the user, group or service account that QuestDB Enterprise grants the owner permissions on the tables and columns a sender auto-creates, like OWNED BY in SQL. An external (OIDC) user must set it to auto-create anything.

  • Connect string reference: a new "Owner of auto-created tables" section under Authentication, a recipe, and a key index entry.
  • QWP ingress protocol: the X-QWP-Owned-By request and response headers, their percent-encoding, the echo a client must check, also when another host of the walk answered 421, the 403 that refuses an owner, also on servers that cannot set one, the 400 of a malformed value, and how the server treats a table or column that another connection creates at the same moment.
  • OIDC: the Entra ID managed identity guide no longer says that ingestion cannot create tables for an external user.
  • Java client: owned_by in the configuration reference.

Dependencies

questdb/questdb#8504, questdb/questdb-enterprise#1572 and questdb/java-questdb-client#130. The pages name QuestDB Enterprise 4.2.2 and Java client 1.3.13 as the first releases with the feature; adjust them if it ships in others.

- connect-string: the owned_by key, which names the user, group or service
  account that receives the owner permissions on the tables and columns a sender
  auto-creates, like OWNED BY in SQL, and which an external user must set to
  auto-create anything. Adds a recipe and a key index entry.
- QWP ingress protocol: the X-QWP-Owned-By request and response headers, their
  percent-encoding, the echo a client must check, and the 400 and 403 refusals.
- OIDC: the managed identity guide no longer says that ingestion cannot create
  tables for an external user.
- Java client: owned_by in the configuration reference.
@github-actions

github-actions Bot commented Nov 19, 2026 •

Copy link
Copy Markdown

🚀 Build success!

Latest successful preview: https://preview-652--questdb-documentation.netlify.app/docs/

Commit SHA: 5bce060

📦 Build generates a preview & updates the link on each commit.

glasstiger and others added 2 commits November 20, 2026 21:17
QuestDB now answers every refused owner on the QWP upgrade with 403,
including on QuestDB open source and Enterprise with access control
disabled, which answered 400: the refusal holds on every host, so like
a failed authentication it ends the endpoint walk. A malformed
X-QWP-Owned-By still gets 400.

The protocol page also says that a missing owned_by echo fails the
connection even when another host of the walk answered 421, and that a
table or column another connection creates at the same moment takes
the write, after a retriable WRITE_ERROR while the other connection
still holds the table's name.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant