tMSSqlConnectionの標準プロパティ - Cloud - 8.0

MSSql

Version
Cloud
8.0
Language
日本語
Product
Talend Big Data
Talend Big Data Platform
Talend Data Fabric
Talend Data Integration
Talend Data Management Platform
Talend Data Services Platform
Talend ESB
Talend MDM Platform
Talend Open Studio for Big Data
Talend Open Studio for Data Integration
Talend Open Studio for ESB
Talend Real-Time Big Data Platform
Module
Talend Studio
Content
ジョブデザインと開発 > サードパーティーシステム > DBコンポーネント > MSSql
データガバナンス > サードパーティーシステム > DBコンポーネント > MSSql
データクオリティとプレパレーション > サードパーティーシステム > DBコンポーネント > MSSql
Last publication date
2023-09-25

このプロパティは [Standard] (標準)ジョブのフレームワークで実行されているtMSSqlConnectionの設定で使用されます。

[Standard] (標準) tMSSqlConnectionコンポーネントは、データベースELTファミリーに属しています。

このフレームワーク内のコンポーネントは、すべてのTalend製品で利用できます。

注: このコンポーネントは、動的データベースコネクターの特定のバージョンです。データベース設定に関連するプロパティは、データベースタイプの選択に応じて異なります。動的データベースコネクターについては、動的データベースコンポーネントをご覧ください。
注: ESB用OSGIバンドルとしてジョブをビルドする場合、SQL Serverコンポーネントで使われるMS SQL Serverドライバーであるjtdsとmssql-jdbcは、ビルドアーティファクトには含まれていません。 Talend Runtimeでアーティファクトを実行する場合は、これらのドライバーを<TalendRuntimePath>/libフォルダーにコピーして手動でデプロイし、 Talend Runtimeを再起動する必要があります。

基本設定

[Database] (データベース)

目的のデータベースタイプをリストから選択し、[Apply] (適用)をクリックします。

[Property type] (プロパティタイプ)

[Built-in] (組み込み)[Repository] (リポジトリー)のいずれかです。

  • [Built-in] (組み込み): 一元的に保存されるプロパティデータはありません。
  • [Repository] (リポジトリー): プロパティが保管されるリポジトリーファイルを選択します。後続フィールドは、取得されたデータを使用して自動的に入力されます。

[JDBC Provider] (JDBCプロバイダー)

使うJDBCドライバーのプロバイダー、[Microsoft] (マイクロソフト) (デフォルト、推奨)または[Open source JTDS] (オープンソースJTDS)を選択します。

Microsoftを選択した場合は、SQL Server用Microsoft JDBCドライバーを[Microsoftダウンロードセンター]からダウンロードし、ダウンロードしたzipファイルを解凍し、解凍したフォルダーからお使いのJREバージョンに基づいてjarを選択し、jarの名前をmssql-jdbc.jarに変更し、手動でインストールする必要があります。jarの選択については、Microsoftダウンロードセンターでシステム要件情報をご覧ください。

OSGiビルドには、オープンソースのjTDSJDBCドライバーが含まれないことにご注意ください。このコンポーネントが含まれているジョブをOSGiバンドルとしてビルドする必要がある時は、Microsoftの公式JDBCドライバーを使用してください。このドライバーを使用しない場合、このコンポーネントは Talend Runtimeに正しくインストールされたjTDSJDBCドライバーを使用するデータソースでのみ機能します。

[Host] (ホスト)

使うデータベースサーバーかAzure Synapse AnalyticsのIPアドレスまたはホスト名を指定します。

サーバーが存在するマシンでSQL Server Browserサービスが実行中である場合は、このフィールドにホスト名とインスタンス名を{host_name}\{instance_name}という形式で指定すれば、TCPダイナミックポートを通じてネームドインスタンスに接続できるようになります。この場合は[Port] (ポート)フィールドを空白のまましておきます。関連情報は、SQL Server Browser serviceをご覧ください。

[Port] (ポート)

使うデータベースサーバーかAzure Synapse Analyticsのリスニングポート番号を入力します。

サーバーが存在するマシンでSQL Server Browserサービスが実行中である場合は、[Host] (ホスト)フィールドにホスト名とインスタンス名を入力し、このフィールドを空にしておけば、TCPダイナミックポートを通じてネームドインスタンスに接続できるようになります。関連情報は、SQL Server Browser serviceをご覧ください。

[Schema] (スキーマ)

スキーマ名。

[Database] (データベース)

データベースの名前。

[Username] (ユーザー名)[Password] (パスワード)

認証データを入力します。

パスワードを入力するためには、[Password] (パスワード)フィールドの横にある[...]ボタンをクリックし、ポップアップダイアログボックスにパスワードを二重引用符で囲んで入力して[OK]をクリックし、設定を保存します。

[Additional JDBC Parameters] (追加のJDBCパラメーター)フィールドにintegratedSecurity=trueを追加し、これら2つのフィールドを空にしておけば、Windows[Type 2 integrated authentication] (タイプ2のインテグレーション認証)を使用できるようになります。関連情報は、Building the connection URLConnecting with integrated authentication On Windowsというセクションをご覧ください。

[Additional JDBC parameters] (追加のJDBCパラメーター)

作成するデータベース接続に接続の追加プロパティを指定します。プロパティはセミコロンで区切られ、各プロパティはキー/値のペアです。たとえばAzure SQLデータベース接続の場合は、encrypt=true;trustServerCertificate=false; hostNameInCertificate=*.database.windows.net;loginTimeout=30;となります。

[Use or register a shared DB Connection] (共有データベース接続を使用または登録)

このチェックボックスをオンにして、データベース接続の共有、または親もしくは子ジョブによって共有されているデータベース接続の取得を行い、[Shared DB Connection Name] (共有データベース接続名)フィールドが表示されたら、共有データベース接続の名前を入力します。これにより、1つのデータベース接続(データベーススキーマの設定は除く)を複数のデータベース接続コンポーネントの間で共有できます。ジョブレベルが異なっていても、親と子のどちらであっても可能です。

このオプションは、tRunJobコンポーネントの[Use dynamic Job] (ダイナミックジョブを使用)および[Use an independent process to run subJob] (サブジョブを独立したプロセスで実行)オプションには対応していません。いずれかのオプションを有効にしてtRunJobコンポーネントで共有接続を使用すると、ジョブが失敗する原因となります。

このチェックボックスは、[Specify a data source alias] (データソースエイリアスを指定)チェックボックスがオンになっている場合は利用できません。

[Specify a data source alias] (データソースエイリアスを指定)

このチェックボックスをオンにして、データソース設定で定義した共有接続プールを使用するために、 Talend Runtime 側で作成したデータソースのエイリアスを指定します。このオプションは、 Talend Runtime 内にジョブをデプロイして実行する時にのみ機能します。

このチェックボックスは、[Use or register a shared DB Connection] (共有データベース接続を使用または登録)チェックボックスがオンになっている場合は表示されません。

[Data source alias] (データソースエイリアス)

Talend Runtime 側で作成したデータソースのエイリアスを入力します。

このフィールドは、[Specify a data source alias] (データソースエイリアスを指定)チェックボックスがオンの場合のみ利用できます。

詳細設定

[Authenticate using Azure Active Directory] (Azure Active Directoryを使って認証)

このオプションを選択すると、接続を確立する時にAzure Active Directory認証を使用できます。関連情報は、Azure AD Authenticationをご覧ください。

このオプションは、[Basic settings] (基本設定)ビューの[JDBC Provider] (JDBCプロバイダー)ドロップダウンリストでMicrosoftが選択されている場合に利用できます。

[Auto Commit] (自動コミット)

トランザクションの実行時に変更が自動的にデータベースにコミットされるようにする場合は、このチェックボックスをオンにします。

このチェックボックスがオンの場合は、対応するコミットコンポーネントを使用して変更をデータベースにコミットできません。同様に、対応するコミットコンポーネントの使用中は、このチェックボックスをオフにしておく必要があります。デフォルトでは、自動コミットファンクションは無効になっており、変更は対応するコミットコンポーネントを使用して明示的にコミットする必要があります。

自動コミットファンクションは、各SQLステートメントを実行の直後に1回のトランザクションとしてコミットしますが、コミットコンポーネントは、すべてのステートメントが実行されるまでコミットしません。このため、ジョブ内でトランザクションの管理にゆとりを必要とする場合は、コミットコンポーネントの使用を推奨します。

[Share identity insert in multi table] (複数テーブル内のID挿入を共有)

同じデータベース接続を通じてデータを受け入れる複数のMicrosoft SQLテーブルの間でIDENTITY_INSERTを共有するには、このチェックボックスをオンにします。

このオプションは、データベース接続を通じてMicrosoft SQLテーブルを書き込む時にIENTITY_INSERTON (またはOFF)に繰り返し設定することで生じるエラーを防ぐことができます。[Basic settings] (基本設定)タブで[Turn on Identity insert] (ID挿入をオンにする)オプションをオンにした状態で、このコンポーネントを複数のtMSSqlOutputコンポーネントと共に使用する場合は、このオプションをオンにする必要があります。

このオプションをオンにすると実行速度が低下する場合があります。

[tStatCatcher Statistics] (tStatCatcher統計)

このチェックボックスをオンにすると、ジョブレベルやコンポーネントレベルでジョブ処理メタデータが収集されます。

使用方法

使用ルール

このコンポーネントは一般的に、他の[tMSSql*]コンポーネント、特にtMSSqlCommitおよびtMSSqlRollbackコンポーネントと共に使用されます。

制限事項

ライセンスの互換性の問題のため、このコンポーネントの使用に必要な1つ以上のJARが提供されていません。この特定のコンポーネントに不足しているJARをインストールするには、Component (コンポーネント)タブビューの[Install] (インストール)ボタンをクリックします。Studioの Integration パースペクティブの[Modules] (モジュール)タブでも、不足しているすべてのJARを簡単に見つけて追加できます。詳細は、外部モジュールをインストールをご覧ください。