Skip to content

Commit 0f0aa48

Browse files
Clare Zheng (Shanghai Wicresoft Co Ltd)Clare Zheng (Shanghai Wicresoft Co Ltd)
authored andcommitted
Add connector lifecycle section
1 parent 8d817a7 commit 0f0aa48

File tree

1 file changed

+17
-17
lines changed

1 file changed

+17
-17
lines changed

articles/data-factory/connector-snowflake.md

Lines changed: 17 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -93,7 +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 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) |
9797
| accountIdentifier | The name of the account along with its organization. For example, myorg-account123. | Yes |
9898
| database | The default database used for the session after connecting. | Yes |
9999
| 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
684684

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

687-
## <a name="upgrade-the-snowflake-linked-service"></a> Upgrade the Snowflake connector
687+
## <a name="differences-between-snowflake-and-snowflake-legacy"></a> Snowflake connector lifecycle and upgrade
688688

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:
690690

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+
### <a name="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
692702

693703
To perform a side-by-side upgrade, complete the following steps:
694704

695705
1. Create a new Snowflake linked service and configure it by referring to the V2 linked service properties.
696706
1. Create a dataset based on the newly created Snowflake linked service.
697707
1. Replace the new linked service and dataset with the existing ones in the pipelines that targets the V1 objects.
698708

699-
### In-place upgrade
709+
#### In-place upgrade
700710

701711
To perform an in-place upgrade, you need to edit the existing linked service payload and update dataset to use the new linked service.
702712

@@ -756,19 +766,9 @@ To perform an in-place upgrade, you need to edit the existing linked service pay
756766

757767
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**.
758768

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-
## <a name="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
765770

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).
772772

773773
## Related content
774774

0 commit comments

Comments
 (0)