次の方法で共有


コネクタのアップグレード ガイダンス

適用対象: Azure Data Factory Azure Synapse Analytics

Tip

企業向けのオールインワン分析ソリューションである Microsoft Fabric の Data Factory をお試しください。 Microsoft Fabric は、データ移動からデータ サイエンス、リアルタイム分析、ビジネス インテリジェンス、レポートまで、あらゆるものをカバーしています。 無料で新しい試用版を開始する方法について説明します。

この記事では、Azure Data Factory のコネクタをアップグレードするためのガイダンスを提供します。

Azure Service Health ポータルで通知を受信する方法

関連するコネクタをアップグレードしたり、EOS と削除の重要な日付を通知したりするために、定期的な通知が送信されます。 通知は、Service Health ポータルの [正常性アドバイザリ] タブで確認できます。

通知を見つけるのに役立つ手順を次に示します。

  1. Service Health ポータルに移動するか、Azure portal ダッシュボードで [Service Health] アイコンを選択できます。

  2. [健康に関する注意] タブに移動すると、コネクタに関連する通知が一覧に表示されます。 [ 正常性履歴 ] タブに移動して、履歴通知を確認することもできます。

    サービス正常性のスクリーンショット。

Service Health ポータルの詳細については、この 記事を参照してください。

データ ファクトリ ポータルから影響を受けるオブジェクトを検索する方法

ここでは、非推奨になったコネクタまたはサポート終了日がはっきりわかっているコネクタにまだ依存しているオブジェクトを調べる手順を示します。 サポート終了日の前に、これらのオブジェクトを新しいコネクタ バージョンにアップグレードするアクションを実行することをお勧めします。

  1. Azure Data Factory を開きます。
  2. [管理] > [リンク サービス] ページに移動します。
  3. V1 上に依然として存在するリンクされたサービスがあり、それに関連付けられたアラートが表示されているはずです。
  4. [関連] 列の下の番号をクリックすると、このリンクされたサービスを利用する関連オブジェクトが表示されます。
  5. アップグレードのガイダンスおよび V1 と V2 の比較の詳細については、各コネクタのページ内のコネクタ アップグレード セクションに移動してください。

リンク サービスのページのスクリーンショット。

影響を受けるオブジェクトをプログラムで検索する方法

ユーザーは PowerShell スクリプトを実行して、サポート対象外またはサポート終了に近いバージョンで実行されている統合ランタイムを使用している Azure Data Factory または Synapse のリンクされたサービスの一覧をプログラムで抽出できます。 スクリプトをカスタマイズして、指定したテナントまたはサブスクリプションの下の各データ ファクトリに対してクエリを実行したり、指定したリンクされたサービスの一覧を列挙したり、接続の種類、コネクタのバージョンなどの構成プロパティを調べたりすることができます。 その後、既知のバージョンの EOS タイムラインに対してこれらの詳細を相互参照し、サポートされていない、または間もなくサポートされなくなるコネクタ バージョンを使用するリンク サービスにフラグを設定できます。 この自動化されたアプローチにより、ユーザーは古いコンポーネントを事前に特定して修復し、継続的なサポート、セキュリティ コンプライアンス、およびサービスの可用性を確保できます。

スクリプトの例を見つけて、必要に応じてカスタマイズできます。

コネクタの自動アップグレード

ユーザーがコネクタを手動でアップグレードするのに役立つ ツールベスト プラクティス が提供されるだけでなく、このサービスでは、必要に応じて、より効率的なアップグレード プロセスも提供されるようになりました。 これは、ユーザーが中断を最小限に抑えながら、最も信頼性が高く、サポートされているコネクタ バージョンを採用できるように設計されています。

次のセクションでは、サービスが自動アップグレードに使用する一般的なアプローチについて説明します。 これは概要を提供しますが、サポートされているシナリオとアップグレード プロセスがワークロードにどのように適用されるかを理解するために、各コネクタに固有のドキュメントを確認することを強くお勧めします。

最新の GA コネクタ バージョンで実行されている特定のシナリオが以前のバージョンと完全に下位互換性がある場合、サービスは既存のワークロード (コピー、ルックアップ、スクリプト アクティビティなど) を、以前のバージョンの動作を保持する互換モードに自動的にアップグレードします。

これらの自動アップグレードされたワークロードは、以前のバージョンの発表された削除日の影響を受けず、ユーザーは直ちに障害が発生することなく、最新の GA バージョンを評価して移行する時間を追加できます。

関連するアップグレードされた情報が記録されているアクティビティの出力を調べることで、どのアクティビティが自動的にアップグレードされたかを特定できます。 次の例は、さまざまなアクティビティ出力のアップグレードされた情報を示しています。

Example:

Copy アクティビティの出力

"source": {
    "type": "AmazonS3",
    "autoUpgrade": "true"
} 

"sink": {
    "type": "AmazonS3",
    "autoUpgrade": "true"
}

検索アクティビティの出力

"source": {
    "type": "AmazonS3",
    "autoUpgrade": "true"
}

スクリプト アクティビティの出力

"source": {
    "type": "AmazonS3",
    "autoUpgrade": "true"
}

Note

互換性モードは柔軟性を提供しますが、継続的な改善、最適化、完全なサポートの恩恵を受けるために、できるだけ早く最新の GA バージョンにアップグレードすることを強くお勧めします。

詳細については、自動アップグレードを計画しているコネクタの一覧の下の表を参照してください。

Connector Scenario
Amazon RDS for Oracle Oracle (バージョン 1.0) の以下の機能に依存しないシナリオ:

• procedureRetResults、batchFailureReturnsError、truststore、truststorepassword を接続プロパティとして使用します。
• クエリはセミコロンで終わります。

パイプラインがセルフホステッド統合ランタイムで実行される場合は、SHIR バージョン 5.56 以降が必要です。
Amazon Redshift Amazon Redshift (バージョン 1.0) の以下の機能に依存しないシナリオ:

• Azure 統合ランタイムを使用するリンクされたサービス。
UNLOAD を使用します。

自動アップグレードは、セルフホステッド統合ランタイムをインストールするコンピューターにドライバーがインストールされている場合にのみ適用されます。

詳細については、 バージョン 2.0 の Amazon Redshift ODBC ドライバーのインストールを参照してください。
Google BigQuery Google BigQuery V1 の以下の機能に依存しないシナリオ:

trustedCertsPathadditionalProjectsrequestgoogledrivescope 接続プロパティを使用します。
• 接続プロパティuseSystemTrustStorefalseとして設定します。
STRUCT データ型と ARRAY データ型を使用します。

パイプラインがセルフホステッド統合ランタイムで実行される場合は、SHIR バージョン 5.55 以降が必要です。
Greenplum パイプラインがセルフホステッド統合ランタイムで実行される場合は、SHIR バージョン 5.56 以降が必要です。
Hive Hive (バージョン 1.0) の以下の機能に依存しないシナリオ:

• 認証の種類:
  • ユーザー名
• Thrift トランスポート プロトコル:
  • HiveServer1
• サービス検出モード: True
• ネイティブ クエリを使用する: True

パイプラインがセルフホステッド統合ランタイムで実行される場合は、SHIR バージョン 5.55 以降が必要です。
Impala Impala (バージョン 1.0) の以下の機能に依存しないシナリオ:

• 認証の種類:
  • SASL ユーザー名

パイプラインがセルフホステッド統合ランタイムで実行される場合は、SHIR バージョン 5.55 以降が必要です。
MariaDB パイプラインがセルフホステッド統合ランタイムで実行される場合は、SHIR バージョン 5.56 以降が必要です。
MySQL パイプラインがセルフホステッド統合ランタイムで実行される場合は、SHIR バージョン 5.56 以降が必要です。
オラクル Oracle (バージョン 1.0) の以下の機能に依存しないシナリオ:

• procedureRetResults、batchFailureReturnsError、truststore、truststorepassword を接続プロパティとして使用します。
• Oracle コネクタをシンクとして使用します。
• クエリはセミコロンで終わります。
• スクリプト アクティビティで PL/SQL コマンドを使用する
• スクリプト アクティビティでスクリプト パラメーターを使用する

パイプラインがセルフホステッド統合ランタイムで実行される場合は、SHIR バージョン 5.56 以降が必要です。
PostgreSQL パイプラインがセルフホステッド統合ランタイムで実行される場合は、SHIR バージョン 5.56 以降が必要です。
Presto Presto (バージョン 1.0) で以下の機能に依存しないシナリオ:

• MAP、ARRAY、または ROW データ型を使用します。
• trustedCertPath/allowSelfSignedServerCert/allowSelfSignedServerCert (間もなくサポートされます)

セルフホステッド統合ランタイムでパイプラインを実行する場合は、SHIR バージョン 5.57 以降が必要です。
Salesforce Salesforce V1 の以下の機能に依存しないシナリオ:

• 次を使用する SOQL クエリ:
  • TYPEOF 句
  • 複合住所/位置情報フィールド
• すべての SQL-92 クエリ
• レポート クエリ {call "<report name>"}
• セルフホステッド統合ランタイムを使用する (サポート対象)
Salesforce Service Cloud Salesforce Service Cloud V1 の以下の機能に依存しないシナリオ:

• 次を使用する SOQL クエリ:
  • TYPEOF 句
  • 複合住所/位置情報フィールド
• すべての SQL-92 クエリ
• レポート クエリ {call "<report name>"}
• セルフホステッド統合ランタイムを使用する (サポート対象)
Snowflake Snowflake V1 の以下の機能に依存しないシナリオ:

• 以下のいずれかを使用する
  properties: connection_timeout、disableocspcheck、enabletaging、on_error、query_tag、quoted_identifiers_ignore_case、skip_header、stage、table、timezone、token、validate_utf8、no_proxy、nonproxyhosts、noproxy。
• スクリプトアクティビティまたはルックアップアクティビティでマルチステートメントクエリを使用します。

パイプラインがセルフホステッド統合ランタイムで実行される場合は、SHIR バージョン 5.56 以降が必要です。
Spark Spark (バージョン 1.0) の以下の機能に依存しないシナリオ:

• 認証の種類:
  • ユーザー名
• Thrift トランスポート プロトコル:
  • SASL
  •バイナリ
• Thrift トランスポート プロトコル:
  • SharkServer
  • SharkServer2

パイプラインがセルフホステッド統合ランタイムで実行される場合は、SHIR バージョン 5.55 以降が必要です。
Teradata Teradata (バージョン 1.0) の以下の機能に依存しないシナリオ:

CharacterSet に以下の値を設定します。
  • BIG5 (TCHBIG5_1R0)
  • EUC (Unix 互換、KANJIEC_0U)
  • GB (SCHGB2312_1T0)
  • IBM メインフレーム (KANJIEBCDIC5035_0I)
  • NetworkKorean (HANGULKSC5601_2R4)
  • Shift-JIS (Windows、DOS 互換、KANJISJIS_0S)
Vertica Vertica (バージョン 1.0) の以下の機能に依存しないシナリオ:

• Azure 統合ランタイムを使用するリンクされたサービス。

自動アップグレードは、セルフホステッド統合ランタイム (バージョン 5.55 以降) をインストールするコンピューターにドライバーがインストールされている場合にのみ適用されます。

詳細については、 バージョン 2.0 の Vertica ODBC ドライバーのインストールを参照してください。