load_layer
Loads a specified semantic layer by ref, connection, or file path and replaces the current session layer, returning updated status so queries use the intended warehouse context.
Instructions
Load one of the layers status listed under layers.
ref: the `ref` from that list, the connection it is for, or a path to
a layer file. Returns the new status. Use it when several layers are
on this machine and the user has said which warehouse they mean --
and after it, tell them which one you loaded. It replaces the layer
this session answers from and leaves every file as it was; a ref that
cannot be loaded comes back as status with an `error`, which still
lists `layers`.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"ref": "<ref>"
},
"name": "load_layer"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ref | Yes | A `ref` from `status.layers`, the connection the layer was built for, or a path to a layer file. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |