From d0e469fddcaa35ef3b67bccb783cd090be704818 Mon Sep 17 00:00:00 2001 From: Dariusz Stempniak Date: Wed, 29 Nov 2023 14:53:11 +0100 Subject: [PATCH 1/3] SNOW-979340 added description how to enable Arrow --- README.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/README.md b/README.md index 13f2ca41d..a91016187 100644 --- a/README.md +++ b/README.md @@ -448,6 +448,29 @@ The .NET driver supports the following mappings from .NET to Snowflake data type | `byte` | `BINARY` | | `datetime` | `DATE` | +Arrow data format +----------------- + +The .NET connector starting from v2.1.3 supports the Arrow data format for data transfers +between Snowflake and the .NET client. The Arrow data format avoids extra +conversions between binary and textual representations of the data. The Arrow +data format can improve performance and reduce memory consumption in clients. + +The data format is controlled by the parameter +DOTNET_QUERY_RESULT_FORMAT. To use Arrow format, execute: + +```snowflake +-- at the session level +ALTER SESSION SET DOTNET_QUERY_RESULT_FORMAT = ARROW; +-- or at the user level +ALTER USER SET DOTNET_QUERY_RESULT_FORMAT = ARROW; +-- or at the account level +ALTER ACCOUNT SET DOTNET_QUERY_RESULT_FORMAT = ARROW; +``` +The valid values for the parameter are: + +- ARROW +- JSON (default) Run a Query and Read Data ------------------------- From 7b234d2664dbb02600786e0c6c843f2bbff304c6 Mon Sep 17 00:00:00 2001 From: Mike Heavin <98060978+sfc-gh-mheavin@users.noreply.github.com> Date: Wed, 29 Nov 2023 10:22:00 -0600 Subject: [PATCH 2/3] Update README.md Minor grammar edits and added a link for Arrow format to apache --- README.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index a91016187..7ff7f7fbf 100644 --- a/README.md +++ b/README.md @@ -451,13 +451,13 @@ The .NET driver supports the following mappings from .NET to Snowflake data type Arrow data format ----------------- -The .NET connector starting from v2.1.3 supports the Arrow data format for data transfers -between Snowflake and the .NET client. The Arrow data format avoids extra +The .NET connector, starting with v2.1.3, supports the [Arrow data format](https://arrow.apache.org/) for data transfers +between Snowflake and a .NET client. The Arrow data format avoids extra conversions between binary and textual representations of the data. The Arrow data format can improve performance and reduce memory consumption in clients. -The data format is controlled by the parameter -DOTNET_QUERY_RESULT_FORMAT. To use Arrow format, execute: +The data format is controlled by the +DOTNET_QUERY_RESULT_FORMAT parameter. To use Arrow format, execute: ```snowflake -- at the session level From dd6909b74f273380a28c2070719c6832db4f90ea Mon Sep 17 00:00:00 2001 From: Dariusz Stempniak Date: Thu, 30 Nov 2023 09:55:43 +0100 Subject: [PATCH 3/3] SNOW-979340 added "as a preview feature" --- README.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 7ff7f7fbf..4594bf8dd 100644 --- a/README.md +++ b/README.md @@ -451,7 +451,8 @@ The .NET driver supports the following mappings from .NET to Snowflake data type Arrow data format ----------------- -The .NET connector, starting with v2.1.3, supports the [Arrow data format](https://arrow.apache.org/) for data transfers +The .NET connector, starting with v2.1.3, supports the [Arrow data format](https://arrow.apache.org/) +as a [preview](https://docs.snowflake.com/en/release-notes/preview-features) feature for data transfers between Snowflake and a .NET client. The Arrow data format avoids extra conversions between binary and textual representations of the data. The Arrow data format can improve performance and reduce memory consumption in clients.