You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
| 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 for version 1.1 (Preview), not supported for version 1.0.|
96
+
| version | The version that you specify. Recommend upgrading to the latest version to take advantage of the newest enhancements. | Yes for version 1.1 (Preview) |
97
97
| accountIdentifier | The name of the account along with its organization. For example, myorg-account123. | Yes |
98
98
| database | The default database used for the session after connecting. | Yes |
99
99
| warehouse | The default virtual warehouse used for the session after connecting. |Yes|
@@ -684,19 +684,29 @@ By setting the pipeline Logging Level to None, we exclude the transmission of in
684
684
685
685
For more information about the properties, see [Lookup activity](control-flow-lookup-activity.md).
686
686
687
-
## <aname="upgrade-the-snowflake-linked-service"></a> Upgrade the Snowflake connector
687
+
## <aname="differences-between-snowflake-and-snowflake-legacy"></a> Snowflake connector lifecycle and upgrade
688
688
689
-
To upgrade the Snowflake connector, you can do a side-by-side upgrade, or an in-place upgrade.
689
+
The following table shows change logs for different versions of the Snowflake connector:
690
690
691
-
### Side-by-side upgrade
691
+
| Version | Release stage | Change log |
692
+
| :----------- | :------- |:------- |
693
+
| Snowflake V1 | GA version available | / |
694
+
| Snowflake V2 (version 1.0) | GA version available | Add support for Key pair authentication.<br><br>The `accountIdentifier`, `warehouse`, `database`, `schema` and `role` properties are used to establish a connection instead of `connectionstring` property.<br><br>Add support for 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 in V2, 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)`<br><br>timestamp data type in Snowflake is read as DateTimeOffset data type in Lookup and Script activity. If you still need to use the Datetime value as a parameter in your pipeline after upgrading to V2, 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')`<br><br>Script parameters are not supported in Script activity. 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).<br><br>Multiple SQL statements execution in Script activity is not supported. |
695
+
| Snowflake V2 (version 1.1) | Preview version available | Add support for script parameters.<br><br>Add support for mutiple statement execution in Script activity. |
696
+
697
+
### <aname="upgrade-the-snowflake-linked-service"></a> Upgrade the Snowflake connector from V1 to V2
698
+
699
+
To upgrade the Snowflake connector from V1 to V2, you can do a side-by-side upgrade, or an in-place upgrade.
700
+
701
+
#### Side-by-side upgrade
692
702
693
703
To perform a side-by-side upgrade, complete the following steps:
694
704
695
705
1. Create a new Snowflake linked service and configure it by referring to the V2 linked service properties.
696
706
1. Create a dataset based on the newly created Snowflake linked service.
697
707
1. Replace the new linked service and dataset with the existing ones in the pipelines that targets the V1 objects.
698
708
699
-
### In-place upgrade
709
+
####In-place upgrade
700
710
701
711
To perform an in-place upgrade, you need to edit the existing linked service payload and update dataset to use the new linked service.
702
712
@@ -756,19 +766,9 @@ To perform an in-place upgrade, you need to edit the existing linked service pay
756
766
757
767
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**.
758
768
759
-
> [!IMPORTANT]
760
-
> If you use the script parameter in V1, you need to apply version 1.1 in the V2 linked service to continue using it.
761
-
762
-
## <aname="differences-between-snowflake-and-snowflake-legacy"></a> Differences between Snowflake V2 and V1
763
-
764
-
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.
769
+
### Upgrade the Snowflake V2 connector from version 1.0 to version 1.1
765
770
766
-
| Snowflake V2 | Snowflake V1 |
767
-
| :----------- | :------- |
768
-
| Support Basic and Key pair authentication. | Support Basic authentication. |
769
-
| 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. |
770
-
| The `accountIdentifier`, `warehouse`, `database`, `schema` and `role` properties are used to establish a connection. | The `connectionstring` property is used to establish a connection. |
771
-
| 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')`|
771
+
In **Edit linked service** page, select 1.1 for version. For more information, see [Linked service properties](#linked-service-properties).
0 commit comments