upload_data
Upload a data file into a CAS table by providing a file path or URL. The server reads the file and creates the table.
Instructions
Upload a data file into a CAS table — read by the server, not the model.
Provide the data by reference through exactly one of:
file_path— the server reads the file off its own disk (in stdio mode that's your machine). Disable withALLOW_LOCAL_FILE_UPLOAD=false.url— the server fetches it over HTTP.
Either way the bytes are read server-side and never pass through the calling
model's context window. To create a small table you are building inline (no
file or URL), use the upload_inline_data tool instead.
The casManagement uploadTable endpoint only accepts an uploaded file (multipart
form-data) and has no URL parameter, so url is fetched and sent on as the
multipart file part.
Formats. Per the uploadTable API: csv, xls, xlsx (single sheet), sas7bdat,
sashdat; tsv is csv with a tab delimiter. parquet is not accepted and is
rejected up front with guidance (load via a path-based caslib +
promote_table_to_memory, or convert to csv/sas7bdat). The format is auto-detected
from the file_path/url extension; pass data_format to override (needed
for URLs with no clean suffix).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | HTTP(S) URL the server fetches the file from. | |
| file_path | No | Path to a data file the server reads directly from disk. | |
| server_id | Yes | CAS server name or ID. | |
| sheet_name | No | For Excel sources, the worksheet to import (first sheet by default). | |
| table_name | Yes | Name for the new table. | |
| caslib_name | Yes | Target caslib name. | |
| data_format | No | Override format detection. One of csv, tsv, xls, xlsx, sas7bdat, sashdat (aliases: excel→xlsx, tab→tsv, sas→sas7bdat). | |
| contains_header_row | No | Whether the first row holds column names — applies to csv/tsv/Excel (default True). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||