tdsql-mcp 1.3.8__tar.gz → 1.4.0__tar.gz

{tdsql_mcp-1.3.8 → tdsql_mcp-1.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tdsql-mcp
-Version: 1.3.8
+Version: 1.4.0
 Summary: MCP server for Teradata Vantage — SQL execution and native analytics function reference for AI agents
 Project-URL: Homepage, https://github.com/ksturgeon-td/tdsql-mcp
 Project-URL: Repository, https://github.com/ksturgeon-td/tdsql-mcp

{tdsql_mcp-1.3.8 → tdsql_mcp-1.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "tdsql-mcp"
-version = "1.3.8"
+version = "1.4.0"
 description = "MCP server for Teradata Vantage — SQL execution and native analytics function reference for AI agents"
 readme = "README.md"
 requires-python = ">=3.10"

{tdsql_mcp-1.3.8 → tdsql_mcp-1.4.0}/skills/teradata-sql-analytics/syntax/catalog-views.md

@@ -139,3 +139,70 @@ JOIN DBC.TablesV t
 WHERE c.DatabaseName = 'mydb'
 ORDER BY c.TableName, c.ColumnId;
 ```
+
+---
+
+## Open Table Format (OTF) Catalog Views
+
+These views cover registered datalakes, external servers, and OTF statistics. They supplement the standard HELP commands (`HELP DATALAKE`, `HELP DATABASE`, `HELP TABLE`) — see `open-table-format` topic for HELP command syntax.
+
+### DBC.DatalakeInfoV — Registered Datalakes
+
+```sql
+-- All registered datalakes and their properties
+SELECT DatalakeName, CatalogType, CatalogURL,
+       ObjectStoragePlatform, AuthorizationName, CommentString
+FROM DBC.DatalakeInfoV
+ORDER BY DatalakeName;
+```
+
+Columns include: `DatalakeName`, `CatalogType` (hive/glue/unity/rest/fabric), `CatalogURL`, `ObjectStoragePlatform` (S3/Azure/GCS), `AuthorizationName`, `CreateTimeStamp`, `CommentString`.
+
+### DBC.ServerV — External Servers
+
+```sql
+-- All external server objects (includes datalakes)
+SELECT ServerName, ServerType, AuthorizationName, CommentString
+FROM DBC.ServerV
+ORDER BY ServerType, ServerName;
+```
+
+### DBC.ManagedOTFTablesV — Managed OTF Tables
+
+Lists OTF tables that Teradata has registered as managed (created via Vantage DDL rather than discovered from the catalog):
+
+```sql
+SELECT DatalakeName, DatabaseName, TableName, TableFormat,
+       CreateTimeStamp, LastAlterTimeStamp
+FROM DBC.ManagedOTFTablesV
+ORDER BY DatalakeName, DatabaseName, TableName;
+```
+
+### DBC.OtfStatsV — OTF Statistics
+
+Statistics collected on OTF table columns (via COLLECT STATISTICS with three-tier notation):
+
+```sql
+-- Statistics collected on OTF tables
+SELECT DatabaseName, TableName, ColumnName, StatsType,
+       LastCollectTimeStamp, SampleSize
+FROM DBC.OtfStatsV
+WHERE DatabaseName = 'my_lake'
+ORDER BY TableName, ColumnName;
+-- DatabaseName here is the datalake name
+```
+
+### DBC.AllStatsV — All Statistics (Teradata + OTF)
+
+Combined view of statistics across both relational Teradata tables and OTF tables:
+
+```sql
+-- All stats (TD + OTF) for a database
+SELECT DatabaseName, TableName, ColumnName, StatsType,
+       LastCollectTimeStamp
+FROM DBC.AllStatsV
+WHERE DatabaseName = 'mydb'
+ORDER BY TableName;
+```
+
+`DBC.StatsV` covers only relational tables. Use `DBC.AllStatsV` when you need a single view across both table types.

{tdsql_mcp-1.3.8 → tdsql_mcp-1.4.0}/skills/teradata-sql-analytics/syntax/guidelines.md

@@ -401,6 +401,27 @@ For full EXPLAIN interpretation guidance, optimization playbook, stats collectio
 
 ---
 
+## External Data Access
+
+### Open Table Format (OTF) — Iceberg and Delta Lake
+
+For working with Apache Iceberg or Delta Lake tables in external catalogs (Hive, Glue, Unity, REST):
+- Load `get_syntax_help(topic='open-table-format')` before writing any OTF DDL or DML
+- OTF tables use three-tier dot notation: `datalake.database.table`
+- **HELP TABLE, not describe_table:** `DBC.ColumnsV` does not cover OTF tables. Use `HELP TABLE my_lake.db.table;` passed through `execute_query` to inspect OTF table columns
+- **HELP commands are first-class statements:** `HELP DATALAKE`, `HELP DATABASE`, `HELP TABLE` query the external catalog directly — do not rewrite them as SELECT queries against DBC views
+- For CREATE/ALTER/DROP TABLE and DML (INSERT/UPDATE/DELETE) on OTF tables, follow the syntax exactly — OTF has significant restrictions vs. relational SQL
+
+### Native Object Store (NOS) — S3, Azure, GCS
+
+For ad-hoc object store access (READ_NOS), persistent access (CREATE FOREIGN TABLE), or export (WRITE_NOS):
+- Load `get_syntax_help(topic='object-store')` before writing any NOS SQL
+- **HELP TABLE, not describe_table:** `DBC.ColumnsV` does not cover foreign tables. Use `HELP TABLE mydb.foreign_table;` or `READ_NOS(USING ... RETURNTYPE('NOSREAD_SCHEMA'))` to discover schema
+- For import workflows, use the foreign table → CAST view → permanent table pattern documented in the `object-store` topic
+- Collect statistics on payload attributes used in joins or filters to improve query plans against foreign tables
+
+---
+
 ## When Manual SQL Is Appropriate
 
 Native functions do not cover everything. Use hand-written SQL for:

{tdsql_mcp-1.3.8 → tdsql_mcp-1.4.0}/skills/teradata-sql-analytics/syntax/index.md

@@ -65,6 +65,12 @@ Use `get_syntax_help(topic="<name>")` to load any topic below.
 |-------|-------------|
 | `geospatial` | ST_Geometry, MBR/MBB types, WKT/WKB formats, spatial relationships (ST_Within, ST_Contains, ST_Distance, etc.), geospatial indexes, tessellation, AggGeom, GeometryToRows, PolygonSplit, MGRS conversion, SYSSPATIAL metadata |
 
+## External Data
+| Topic | Description |
+|-------|-------------|
+| `open-table-format` | Iceberg v2 and Delta Lake v3 via external catalogs (Hive/Glue/Unity/REST): CREATE DATALAKE, three-tier `datalake.db.table` notation, SELECT/DML, time travel, metadata functions (TD_SNAPSHOTS, TD_MANIFESTS, TD_PARTITIONS, TD_HISTORY), CREATE/ALTER/DROP TABLE, COLLECT STATS, type mappings, limitations |
+| `object-store` | Native Object Store (NOS): CREATE FOREIGN TABLE for persistent access, READ_NOS for ad-hoc reads and schema discovery, WRITE_NOS for export to S3/Azure/GCS; Parquet/CSV/JSON formats; PATHPATTERN partition pruning; SNAPSHOT_LOCATION; import workflow; best practices |
+
 ## Reference
 | Topic | Description |
 |-------|-------------|
@@ -94,6 +100,9 @@ Recommended topic reading order for common end-to-end tasks. Load these topics i
 | **Micromodeling (per-segment models)** | `ml-functions` (TD_GLM) → `ml-patterns` (micromodeling) |
 | **Semantic search / RAG embeddings** | `authorization-objects` → `llm-providers` → `embeddings` → `vector-search` |
 | **In-database ONNX inference** | `byom-model-loading` → `embeddings` (ONNXEmbeddings) → `vector-search` |
+| **Query Iceberg / Delta Lake tables** | `open-table-format` |
+| **Import NOS data into Vantage** | `object-store` (foreign table → CAST view → permanent table) |
+| **Export Vantage data to S3/Azure/GCS** | `object-store` (WRITE_NOS) |
 | **Time series forecasting (ARIMA)** | `uaf-concepts` → `uaf-data-prep` → `uaf-estimation` → `uaf-forecasting` → `uaf-diagnostics` |
 | **Regression on ordered series** | `uaf-concepts` → `uaf-data-prep` → `uaf-estimation` (TD_LINEAR_REGR / TD_MULTIVAR_REGR) → `uaf-diagnostics` |
 | **Frequency / spectral analysis** | `uaf-concepts` → `uaf-dsp` (TD_DFFT, TD_POWERSPEC, TD_LINESPEC) |