Microsoft Connector for Teradata (SSIS)

  • [アーティクル]

適用対象:SQL Server Azure Data Factory の SSIS Integration Runtime

Microsoft Connector for Teradata を使用すると、SSIS パッケージ内の Teradata データベースにデータをエクスポートおよび読み込むことができます。

この新しいコネクタでは、1MB 対応のテーブルを持つデータベースがサポートされます。

バージョンのサポート

Microsoft Connector では、次の Teradata 用の Microsoft SQL Server 製品がサポートされています。

  • Microsoft SQL Server 2019
  • Microsoft SQL Server 2022
  • Visual Studio 2019 用の SQL Server Integration Services プロジェクト
  • Visual Studio 2022 用の SQL Server Integration Services プロジェクト

Microsoft Connector for Teradata は、ODBC Driver for Teradata と、Teradata Tools and Utilities (TTU) に付属する Teradata Parallel Transporter を使用します。 サポートされている TTU バージョンは、16.20 と 17.10 です。

インストール

Teradata サイトから TTU をインストールします。 インストール時に ODBC Driver for Teradata と Teradata Parallel Transporter の機能が選択されていることを確認します。

Teradata データベースのコネクタをインストールするには、Microsoft Connector for Teradata の最新版からインストーラーをダウンロードし、実行します。 そのうえでインストール ウィザードの指示に従います。

注意

SQL Server Integration Services プロジェクトを使用してパッケージを設計するには、ターゲットと最新の SQL Server バージョンの両方のコネクタをインストールする必要があります。

コネクタをインストールしたら、SQL Server 統合サービスを再起動して、Teradata のソースと変換先が正常に機能することを確認する必要があります。

SSIS パッケージのデザインと実行

Microsoft Connector for Teradata は、Attunity Teradata Connector と同様のユーザー エクスペリエンスを提供します。 ユーザーは、SSDT for VS 2017 または VS 2019 を使用して "SQL Server 2019 をターゲットにする" ことで、以前のエクスペリエンスに基づいて新しいパッケージをデザインできます。

Teradata のソースと変換先は、[共通] カテゴリにあります。

Screenshot the Teradata Component.

Teradata 接続マネージャーは、"TERADATA" として表示されます。

Screenshot of the Teradata connection manager type

Attunity Teradata Connector を使用してデザインされた既存の SSIS パッケージは、Microsoft Connector for Teradata を使用するように自動的にアップグレードされます。 アイコンも変更されます。

SQL Server 2017 以前をターゲットとする SSIS パッケージを実行するには、以下のリンクから対応するバージョンの Microsoft Connector for Teradata by Attunity をインストールする必要があります。

SSDT で SQL Server 2017 以前をターゲットとする SSIS パッケージをデザインするには、Microsoft Connector for Teradata を用意したうえで、対応するバージョンの Microsoft Connector for Teradata by Attunity をインストールする必要があります。

制限事項と既知の問題

  • Teradata ソース/変換先エディター、[既定のデータベース] プロパティが有効になりません。 回避策として、テーブルまたはビューをフィルター処理するためのドロップダウン ボックスにデータベース名を入力します。

  • Teradata ソース/変換先エディター、\<database>.<table/view> と入力した場合、マッピング手順が機能しません。 回避策として、\<database>.<table/view> と入力してからドロップダウン ボタンをクリックします。

  • Teradata ソース エディター、データ アクセス モードが "テーブル名 – TPT エクスポート" である場合に、ビューを表示できません。回避策として、Teradata ソースの詳細エディターを使用します。

  • Teradata 変換先、属性 "PackMaximum" を "True" に設定することができません。それを行わないと、エラーが発生します。

  • Teradata ソースは、常に、テーブルで定義されている順序で列を読み取ります。 一方、ODBC は、列を特定の状況で特定の順序で読み取る必要があります (「長い形式のデータの取得」および「SQLGetData」)。 2 つの順序が一致しない場合、"記述子のインデックスが無効です。記述子のレコードが存在しないか、適切に初期化されていません。" というエラー メッセージが表示され、読み取りは失敗します。

  • 古いインストールに新しいバージョンをインストールしても、インストール済みのプログラム一覧から古いバージョンのエントリは削除されません。 新しいバージョンの機能には影響しませんが、ユーザーはコントロール パネルの [プログラムと機能] で古いバージョンを手動でアンインストールして、古いバージョンのエントリを削除できます。

アンインストール

アンインストール ウィザードを実行すれば、Microsoft Connector for Teradata を削除できます。

リリース ノート

リビジョン 275

バグの修正

  • Teradata 変換先は、特定の状況でクラッシュします。
  • Teradata 変換先は、特定の状況でエラーが発生したにもかかわらず成功を報告します。
  • Teradata 変換先は、特定の状況で実際よりも多くの行が書き込まれたと報告します。

機能強化

  • エラーが発生すると、Teradata 変換先はユーザーを保持し、調査のために TPT エラー テーブルに誘導します。

リビジョン 257

バグの修正

  • Teradata 変換先のメモリ リーク。
  • Teradata 変換先が、空の文字列を使用するときにエラー メッセージ "an error occurred when converting string from source codepage (ソース コード ページから文字列を変換するときにエラーが発生しました)" で失敗します。
  • 一定の条件下で、Teradata 変換先でエラーが発生したにもかかわらず、データ フロー タスクより成功したと報告されます。
  • Teradata 変換先は、非常に長い VARCHAR 値が書き込まれると失敗します。

機能強化

  • Teradata 変換先のパフォーマンスが改善されました。
  • Teradata 接続マネージャーで、接続失敗のエラーの詳細がログに記録されます。

リビジョン 240

バグの修正

  • 24 列以上の表形式データを処理すると、メッセージ [Teradata][ODBC] (10670) Invalid descriptor index, descriptor record does not exist, or descriptor record was not properly initialized. のエラーが発生します
  • 新しく作成された Teradata 接続マネージャーは、サポートされていない場合でも、既定で最新バージョンの Teradata ODBC ドライバーがインストールされます。

リビジョン 233

バグの修正

  • 新しく作成された Teradata 接続マネージャーでは、DRIVER のような必須の接続文字列プロパティの一部が既定では設定されません。

リビジョン 225

新機能

  • TTU 17.10 のサポートを追加。

バグの修正

  • Teradata ソースでは、特定の状況で正しくないデータを読み込んでしまう可能性があります。
  • Teradata 変換先の既定のエラー テーブルは、名前が正しくなく、変換先テーブルのデータベース内に作成されない可能性があります。
  • Teradata 接続マネージャーの接続文字列プロパティで指定されたオプションが取得されず、有効にならない場合があります。

リビジョン 197

バグの修正

  • 空の文字列データを読み取るとき、Teradata Source が "文字列をターゲット コードページに変換するときにエラーが発生しました" というエラー メッセージで失敗します。

次のステップ