Skip to content

Commit 5e1783c

Browse files
Clare Zheng (Shanghai Wicresoft Co Ltd)Clare Zheng (Shanghai Wicresoft Co Ltd)
authored andcommitted
Add script parameter support for Snowflake
1 parent d629dc2 commit 5e1783c

File tree

1 file changed

+9
-2
lines changed

1 file changed

+9
-2
lines changed

articles/data-factory/connector-snowflake.md

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ author: jianleishen
77
ms.subservice: data-movement
88
ms.topic: conceptual
99
ms.custom: synapse
10-
ms.date: 01/23/2025
10+
ms.date: 04/01/2025
1111
ai-usage: ai-assisted
1212
---
1313

@@ -93,6 +93,7 @@ These generic properties are supported for the Snowflake linked service:
9393
| Property | Description | Required |
9494
| :--------------- | :----------------------------------------------------------- | :------- |
9595
| type | The type property must be set to **SnowflakeV2**. | Yes |
96+
| version | The version that you specify. Recommend upgrading to the latest version to take advantage of the newest enhancements. | Yes |
9697
| accountIdentifier | The name of the account along with its organization. For example, myorg-account123. | Yes |
9798
| database | The default database used for the session after connecting. | Yes |
9899
| warehouse | The default virtual warehouse used for the session after connecting. |Yes|
@@ -683,6 +684,10 @@ By setting the pipeline Logging Level to None, we exclude the transmission of in
683684

684685
For more information about the properties, see [Lookup activity](control-flow-lookup-activity.md).
685686

687+
## Script activity properties
688+
689+
For more information about the properties, see [Script activity](transform-data-using-script.md). Apply version 1.1 in the linked service if you want to use the script parameter.
690+
686691
## <a name="upgrade-the-snowflake-linked-service"></a> Upgrade the Snowflake connector
687692

688693
To upgrade the Snowflake connector, you can do a side-by-side upgrade, or an in-place upgrade.
@@ -755,14 +760,16 @@ To perform an in-place upgrade, you need to edit the existing linked service pay
755760

756761
1. Update dataset to use the new linked service. You can either create a new dataset based on the newly created linked service, or update an existing dataset's type property from **SnowflakeTable** to **SnowflakeV2Table**.
757762

763+
> [!IMPORTANT]
764+
> If you use the script parameter in V1, you need to apply version 1.1 in the V2 linked service to continue using it.
765+
758766
## <a name="differences-between-snowflake-and-snowflake-legacy"></a> Differences between Snowflake V2 and V1
759767

760768
The Snowflake V2 connector offers new functionalities and is compatible with most features of Snowflake V1 connector. The table below shows the feature differences between V2 and V1.
761769

762770
| Snowflake V2 | Snowflake V1 |
763771
| :----------- | :------- |
764772
| Support Basic and Key pair authentication. | Support Basic authentication. |
765-
| Script parameters are not supported in Script activity currently. As an alternative, utilize dynamic expressions for script parameters. For more information, see [Expressions and functions in Azure Data Factory and Azure Synapse Analytics](control-flow-expression-language-functions.md). | Support script parameters in Script activity. |
766773
| Support BigDecimal in Lookup activity. The NUMBER type, as defined in Snowflake, will be displayed as a string in Lookup activity. If you want to covert it to numeric type, you can use the pipeline parameter with [int function](control-flow-expression-language-functions.md#int) or [float function](control-flow-expression-language-functions.md#float). For example, `int(activity('lookup').output.firstRow.VALUE)`, `float(activity('lookup').output.firstRow.VALUE)`| BigDecimal is not supported in Lookup activity. |
767774
| The `accountIdentifier`, `warehouse`, `database`, `schema` and `role` properties are used to establish a connection. | The `connectionstring` property is used to establish a connection. |
768775
| timestamp data type in Snowflake is read as DateTimeOffset data type in Lookup and Script activity. | timestamp data type in Snowflake is read as DateTime data type in Lookup and Script activity.<br> If you still need to use the Datetime value as a parameter in your pipeline after upgrading the connector, you can convert DateTimeOffset type to DateTime type by using [formatDateTime function](control-flow-expression-language-functions.md#formatdatetime) (recommended) or [concat function](control-flow-expression-language-functions.md#concat). For example: `formatDateTime(activity('lookup').output.firstRow.DATETIMETYPE)`, `concat(substring(activity('lookup').output.firstRow.DATETIMETYPE, 0, 19), 'Z')`|

0 commit comments

Comments
 (0)