Skip to content

Commit 18e6e72

Browse files
committed
docs(data-modeling): ObjectSchema.create() refuses only the 'default' half of an external binding (#25211)
The section 2 paragraph credited ObjectSchema.create() with refusing a binding on a managed named datasource, which it cannot see. It refuses the 'default' half; defineStack and composeStacks refuse both halves for a datasource the stack or another input declares; the runtime save door answers 422. Claude-Session: https://claude.ai/code/session_01QVYg9FaRCUgSV13upGJSZQ Co-authored-by: Claude <noreply@anthropic.com>
1 parent 4f2cf24 commit 18e6e72

1 file changed

Lines changed: 5 additions & 3 deletions

File tree

‎content/docs/data-modeling/external-datasources.mdx‎

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -91,9 +91,11 @@ That's it. `GET /api/v1/data/ext_customer` now returns live rows from the remote
9191

9292
The object's **own** `datasource` must name a datasource declared
9393
`schemaMode: 'external'` or `'validate-only'` (ADR-0015 §4.2). An `external` binding on
94-
`'default'` (also the value when `datasource` is omitted) or on a `managed` datasource is
95-
refused — by `ObjectSchema.create()`, `defineStack` and `composeStacks`, and at runtime by
96-
`PUT /api/v1/meta/object/<name>` with `422 INVALID_METADATA`. The same save door refuses
94+
`'default'` (also the value when `datasource` is omitted) is refused by `ObjectSchema.create()`,
95+
which sees only the object. A binding on either `'default'` or a `managed` datasource is refused
96+
by `defineStack` and `composeStacks` (for a datasource the stack, or another input of the
97+
composition, declares), and at runtime by `PUT /api/v1/meta/object/<name>` with
98+
`422 INVALID_METADATA`. The same save door refuses
9799
`PUT /api/v1/meta/datasource/<name>` that would make a datasource `managed` while objects
98100
bind it with `external`: change the datasource to `external` before binding objects, and
99101
remove `external` from the objects before making it managed.

0 commit comments

Comments
 (0)