plan_table_creation
Creates a table import plan from S3 parquet files by scanning schemas and generating a YAML plan, returning a job ID for tracking.
Instructions
Generate a YAML schema plan for importing a table from an S3 URI in the user's Bauplan data catalog returning a job ID for tracking). Create a table import plan from an S3 location.
This operation will attempt to create a table based of schemas of N parquet files found by a given search uri. A YAML file containing the schema and plan is returned and if there are no conflicts, it is automatically applied.
Args: table: Name of the table to plan creation for. search_uri: S3 URI to search for parquet files. namespace: Optional namespace (defaults to "bauplan"). branch: Optional branch name. partitioned_by: Optional partitioning column. replace: Optional flag to replace existing table.
Returns: TablePlanCreated: Object indicating success/failure with job tracking details
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| table | Yes | ||
| search_uri | Yes | ||
| namespace | No | ||
| branch | No | ||
| partitioned_by | No | ||
| replace | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job_id | Yes | ||
| table_name | Yes | ||
| search_uri | Yes | ||
| success | Yes | ||
| message | Yes | ||
| namespace | Yes | ||
| branch | Yes |