次の方法で共有

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 2022
  • Microsoft SQL Server 2019
  • Visual Studio 2022 用の SQL Server Integration Services プロジェクト

Microsoft Connector for Teradata は、Teradata Tools and Utilities (TTU) 20.00 に依存します。

Note

TTU では、32 ビット Teradata Parallel Transporter (TPT) のサポートが廃止されました。 これに伴い、Microsoft Connector for Teradata では、32 ビットおよび Visual Studio 2019 のサポートが廃止されました。 TTU 17.10 ベースのリビジョン 284 は、32 ビットおよび Visual Studio 2019 がサポートされる最終バージョンです。 最新バージョンと同様にこちらのページからダウンロードできます。

インストール

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 のソースと変換先は、[共通] カテゴリにあります。

Teradata コンポーネントのスクリーンショット。

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

Teradata 接続マネージャーの種類のスクリーンショット

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 を削除できます。

リリース ノート

リビジョン 285

機能強化

  • TTU 依存関係をバージョン 20.00 にアップグレードします。

リビジョン 284

バグの修正

  • 発表されたバグ修正と機能改善の一部は、リビジョン 282 では欠落しています。

リビジョン 282

バグの修正

  • Teradata ソースは、SQL コマンド (SQL コマンド - TPT エクスポート データ アクセス モード) で改行文字を処理できません。
  • Teradata 変換先は、特定の状況下でクラッシュします。
  • Teradata 接続マネージャー エディターで指定された認証メカニズムは保持されず、有効になりません。

リビジョン 275

バグの修正

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

機能強化

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

リビジョン 257

バグの修正

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

機能強化

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

リビジョン 240

バグの修正

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

リビジョン 233

バグの修正

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

リビジョン 225

新機能

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

バグの修正

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

リビジョン 197

バグの修正

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

次のステップ