From 0339bfd91293769ca439603dde2d45f0ccf47357 Mon Sep 17 00:00:00 2001 From: Jiri Semmler Date: Fri, 25 Sep 2026 10:51:14 +0200 Subject: [PATCH] README: clarify tables.create vs tables.load The README only showed tables.create under a generic "save data" comment, while the developer docs show tables.load. Both are correct but do different things: create makes a new table from a CSV file, load imports data into an existing table (full or incremental). Show both so the two documents no longer look contradictory. Fixes #84 Co-Authored-By: Claude Fable 5.1 --- README.md | 13 +++++++++++-- 1 file changed, 11 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 969c176..6a9caec 100644 --- a/README.md +++ b/README.md @@ -25,9 +25,15 @@ client = Client('https://connection.keboola.com', 'your-token') # get table data into local file client.tables.export_to_file(table_id='in.c-demo.some-table', path_name='/data/') -# save data +# create a new table from a CSV file client.tables.create(name='some-table-2', bucket_id='in.c-demo', file_path='/data/some-table') +# load data into an existing table (full load replaces the data) +client.tables.load(table_id='in.c-demo.some-table-2', file_path='/data/some-table') + +# load data into an existing table incrementally (append rows / upsert by primary key) +client.tables.load(table_id='in.c-demo.some-table-2', file_path='/data/some-table', is_incremental=True) + # list buckets client.buckets.list() @@ -49,9 +55,12 @@ tables = Tables('https://connection.keboola.com', 'your-token') # get table data into local file tables.export_to_file(table_id='in.c-demo.some-table', path_name='/data/') -# save data +# create a new table from a CSV file tables.create(name='some-table-2', bucket_id='in.c-demo', file_path='/data/some-table') +# load data into an existing table (use is_incremental=True to append instead of replace) +tables.load(table_id='in.c-demo.some-table-2', file_path='/data/some-table') + # list buckets buckets = Buckets('https://connection.keboola.com', 'your-token') buckets.list()