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

Sybase

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 Real-Time Big Data Platform
Module
Talend Studio
Content
ジョブデザインと開発 > サードパーティーシステム > DBコンポーネント > Sybase
データガバナンス > サードパーティーシステム > DBコンポーネント > Sybase
データクオリティとプレパレーション > サードパーティーシステム > DBコンポーネント > Sybase
Last publication date
2024-02-28

これらのプロパティは、標準ジョブのフレームワークで実行されているtSybaseIQBulkExecを設定するために使われます。

標準tSybaseIQBulkExecコンポーネントは、データベースファミリーに属しています。

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

注: このコンポーネントは、動的データベースコネクターの特定のバージョンです。データベース設定に関連するプロパティは、データベースタイプの選択に応じて異なります。動的データベースコネクターについては、DB Genericコンポーネントをご覧ください。

基本設定

データベース

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

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

接続の詳細を設定する方法を選択します。

  • [Built-In] (組み込み): このコンポーネントの接続の詳細がローカルに設定されます。関連するすべての接続のプロパティ値を手動で指定する必要があります。

  • [Repository] (リポジトリー): [Repository] (リポジトリー) > [Metadata] (メタデータ)で一元的に保存された接続の詳細が、このコンポーネントによって再使用されます。

    このチェックボックスの横にある [...] ボタンをクリックし、表示された [Repository Content] (リポジトリーのコンテンツ)ダイアログボックスで、再使用する接続の詳細を選択すると、関連するすべての接続のプロパティに値が自動的に入力されます。

[Use an existing connection] (既存の接続を使用)

定義済みの接続の詳細を再利用する場合は、このチェックボックスをオンにして、[Component List] (コンポーネントリスト)ドロップダウンリストから、目的の接続コンポーネントを選択します。

tSybaseConnectionコンポーネントで作成した既存のSybase 16 (SQL Anywhere)接続を再利用し、クライアント側にあるファイルからデータをロードする場合は、このチェックボックスをオンにする前に、[DB Version] (データベースバージョン)ドロップダウンリストから、Sybase 16 (SQL Anywhere)を選択して、[Is client file] (Isクライアントファイル)チェックボックスを表示する必要があります。

注: ジョブに親ジョブと子ジョブが含まれている時は、親ジョブと子ジョブの間の既存の接続を共有したい場合(たとえば、親ジョブで作成した接続を子ジョブと共有するなど)には、次のように実行します。
  1. 親レベルで、共有するデータベース接続を、そのデータベース接続そのものを作成する接続コンポーネントの[Basic settings] (基本設定)ビューに登録します。
  2. 子レベルで、登録済みのそのデータベース接続を読み取るために専用の接続コンポーネントを使用します。

ジョブレベル全体でデータベース接続を共有する方法の例は、データベース接続を共有をご覧ください。

Sybase IQ 15[DB Version] (データベースバージョン)ドロップダウンリストから、選択した場合、これらのプロパティは、利用できません。

[DB Version] (データベースバージョン)

ドロップダウンリストから、使用するSybaseデータベースのバージョンを選択します。

  • Sybase IQ 12とSybase IQ 16の場合、一括ロードするファイルは、Sybase IQサーバーと同じマシンに置いておく必要があります。

  • Sybase IQ 15の場合、一括ロードするファイルはクライアント側に置いておくことができますが、これは、Sybase IQサーバー側に必要な設定があることを意味します。詳細は、Sybase IQ client-side load support enhancementsをご覧ください。

  • Sybase 16 (SQL Anywhere)の場合、一括ロードするファイルは、サーバー側とクライアント側の両方に置いておくことができます。

    データをSybase 16 (SQL Anywhere)にロードする前に、SQL Anywhere 17をインストールする必要があります。ここからダウンロードしてください。インストールが終了したら、システム変数Pathをチェックして、SQL Anywhere 17のインストールパスが追加されていることを確認します。続いてTalend Studioを再起動し(コンピューターの再起動が必要な場合もあります)、新しいPath変数を有効にします。

ホスト

データベースのIPアドレスまたはホスト名。

Sybase IQ 15[DB Version] (データベースバージョン)ドロップダウンリストから、選択した場合、これらのプロパティは、利用できません。

[Port] (ポート)

データベースのリスニングポート番号。

Sybase IQ 15[DB Version] (データベースバージョン)ドロップダウンリストから、選択した場合、これらのプロパティは、利用できません。

[Data Source] (データソース)

使用するデータソースのタイプを選択し、となりのフィールドに対応するDSN情報を入力します。利用できるタイプは、DSNFILEDSNです。

FILEDSNを選択した場合、[Data Source] (データソース)フィールドの横に[...]ボタンがあり、目的のデータソースファイルに移動できます。

これらのプロパティは、Sybase IQ 15[DB Version] (データベースバージョン)ドロップダウンリストから、選択した場合に利用できます。

[Database] (データベース)

データベースの名前。

[Sybase Schema] (Sybaseスキーマ)

データベースのスキーマ。

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

データベースユーザー認証データ。

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

[Table] (テーブル)

書き込まれるテーブルの名前。

[Action on table] (テーブルでのアクション)

定義済みのテーブルで、次のオペレーションの1つを実行できます。

  • [Default] (デフォルト): 操作は行われません。

  • [Drop and create table] (ドロップしてテーブルを作成): テーブルが削除され、再作成されます。

  • [Create table] (テーブルを作成): テーブルが存在しないため、作成されます。

  • [Create table if not exists] (テーブルが存在しない場合は作成): テーブルが存在しない場合は作成されます。

  • [Drop table if exist and create] (テーブルが存在する場合はドロップして作成): テーブルが既に存在する場合は削除されて再作成されます。

  • [Clear table] (テーブルをクリア): テーブルの内容が削除されます。

  • [Truncate table] (テーブルを切り詰め): テーブルの内容が削除されます。操作をロールバックすることはできません。

[Local filename] (ローカルファイル名)

ロードするファイルへのパス。

[Is client file] (Isクライアントファイル)

データをクライアント側からロードする必要がある場合は、このチェックボックスをオンにします。

これらのプロパティは、Sybase 16 (SQL Anywhere)[DB Version] (データベースバージョン)ドロップダウンリストから、選択した場合に利用できます。

[Schema] (スキーマ)[Edit schema] (スキーマを編集)

スキーマとは行の説明のことです。処理して次のコンポーネントに渡すフィールド(カラム)数を定義します。Sparkジョブを作成する場合、フィールドの命名時は予約語のlineを避けます。

  • [Built-in] (組み込み): そのコンポーネントに対してのみスキーマを作成し、ローカルに保管します。

  • [Repository] (リポジトリー): スキーマは作成済みで、リポジトリーに保管されています。さまざまなプロジェクトやジョブデザインで再利用できます。

スキーマを変更するには[Edit schema] (スキーマを編集)をクリックします。変更を加えると、スキーマは自動的に組み込みになります。

  • [View schema] (スキーマを表示): スキーマのみを表示する場合は、このオプションを選択します。

  • [Change to built-in property] (組み込みのプロパティに変更): ローカルで変更を行うためにスキーマを組み込みに変更する場合は、このオプションを選択します。

  • [Update repository connection] (リポジトリー接続をアップデート): リポジトリーに保存されているスキーマに変更を加え、変更後にそのコンテンツをすべてのジョブにプロパゲートするかどうかを決める場合は、このオプションを選択します。

    変更を現在のジョブにのみ反映する場合は、変更後、[No] (いいえ)を選択し、[Repository Content] (リポジトリーコンテンツ)ウィンドウで再びこのスキーマのメタデータを選択します。

[Use Insert-Location] (挿入ロケーションの使用)

このチェックボックスをオンにして、データをSybaseテーブルにインポートするソースデータベーステーブルを指定します。

サーバー

インポートするデータを保管するサーバーの名前。

これらのプロパティは、[Use Insert-Location] (挿入ロケーションの使用)チェックボックスがオンの場合にのみ使用できます。

[Database] (データベース)

インポートするデータを保管するデータベースの名前。

これらのプロパティは、[Use Insert-Location] (挿入ロケーションの使用)チェックボックスがオンの場合にのみ使用できます。

[Schema] (スキーマ)

ソーススキーマの名前。

これらのプロパティは、[Use Insert-Location] (挿入ロケーションの使用)チェックボックスがオンの場合にのみ使用できます。

[Table] (テーブル)

ソーステーブルの名前。

これらのプロパティは、[Use Insert-Location] (挿入ロケーションの使用)チェックボックスがオンの場合にのみ使用できます。

[Use Source Filter] (ソースフィルターの使用)

このチェックボックスをオンにして、ソーステーブルで行フィルターを指定します。

これらのプロパティは、[Use Insert-Location] (挿入ロケーションの使用)チェックボックスがオンの場合にのみ使用できます。

[Where Clause] (Where句)

Sybaseテーブルにインポートする行をフィルタリングするwhere句。

これらのプロパティは、[Use Source Filter] (ソースフィルターの使用)チェックボックスがオンの場合にのみ使用できます。

[Columns Mapping] (カラムのマッピング)

このテーブルを完成して、ソーステーブルカラムと Sybaseテーブルカラムの間のマッピング関係を指定します。

  • [Column] (カラム): Sybaseテーブルカラムの名前。デフォルトでは、[Column] (カラム)カラムのフィールドはスキーマ内のフィールドと同じです。

  • [Columns in Source Table] (ソーステーブル内のカラム): データのインポート元となるテーブル内の対応するカラムの名前。

これらのプロパティは、[Use Insert-Location] (挿入ロケーションの使用)チェックボックスがオンの場合にのみ使用できます。

詳細設定

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

作成するデータベース接続に追加のJDBCパラメーターを指定します。

[Lines terminated by] (行区切り)

行の区切りに使用する文字または連続する文字。

これらのプロパティは、[Use Insert-Location] (挿入ロケーションの使用)チェックボックスがオンの場合には使用できません。

[Fields terminated by] (フィールド区切り)

フィールドを区切るために使用される文字、文字列、または正規表現。

Sybaseの構文に準拠した行/フィールド区切りにより、このコンポーネントではSybase指向の区切り、たとえば\x09のような文字を使用できます。

これらのプロパティは、[Use Insert-Location] (挿入ロケーションの使用)または[Use fixed length] (固定長の使用)チェックボックスがオンの場合には使用できません。

[Use enclosed quotes] (囲む引用符の使用)

データのエンクロージャー文字を使用する場合は、このチェックボックスをオンにします。

これらのプロパティは、[Use Insert-Location] (挿入ロケーションの使用)または[Use fixed length] (固定長の使用)チェックボックスがオンの場合には使用できません。

[Use fixed length] (固定長の使用)

このチェックボックスをオンにすると、データ行の固定幅が設定されます。

これらのプロパティは、[Use Insert-Location] (挿入ロケーションの使用)チェックボックスがオンの場合には使用できません。

[Include Header] (ヘッダーを含める)

ロードされるファイルにヘッダーが含まれている場合は、このチェックボックスをオンにします。

これらのプロパティは、[Use Insert-Location] (挿入ロケーションの使用)チェックボックスがオンの場合には使用できません。

[Blank as null] (空白をNullにする)

このチェックボックスをオンにすると、長さ0で入力された可変長文字はデータベースのロード操作中にブランクとしてではなくNULLとして保管されます。

これらのプロパティは、[Use Insert-Location] (挿入ロケーションの使用)または[Use fixed length] (固定長の使用)チェックボックスがオンの場合には使用できません。

[On file error] (ファイルエラーについて)

エラー発生時にSybaseによって実行されるアクションを選択します。

  • [Rollback (default)] (ロールバック(デフォルト)): トランザクション全体をロールバックします。

  • [Finish] (終了): 既に完了している挿入を終了し、ロードオペレーションを終えます。

  • [Continue] (続行): エラーをスキップしてロードオペレーションを続行します。

これらのプロパティは、Sybase 16 (SQL Anywhere)[DB Version] (データベースバージョン)ドロップダウンリストから、選択した場合に利用できます。

[Message log file] (メッセージログファイル)

整合性制約違反、違反のタイプ、その他に関するログ情報を保存するMESSAGE LOGファイルへのパス。[Row log file] (行ログファイル)プロパティと一緒に指定する必要があります。

これらのプロパティは、Sybase 16 (SQL Anywhere)[DB Version] (データベースバージョン)ドロップダウンリストから、選択した場合に利用できます。

[Row log file] (行ログファイル)

リジェクトデータのログ情報、ロードの開始と完了のタイムスタンプ、その他を保存するROW LOGファイルへのパス。[Message log file] (メッセージログファイル)プロパティと一緒に指定する必要があります。

これらのプロパティは、Sybase 16 (SQL Anywhere)[DB Version] (データベースバージョン)ドロップダウンリストから、選択した場合に利用できます。

[Location Options] (ロケーションオプション)

ロケーションオプションを表示するには、このチェックボックスをオンにします。ロケーションオプションの詳細は、http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.infocenter.dc00801.1510/html/iqrefso/X315746.htmをご覧ください。

これらのプロパティは、[Use Insert-Location] (挿入ロケーションの使用)チェックボックスがオンの場合にのみ使用できます。

[Encrypted Password] (暗号化されたパスワード)

リモートソースサーバーに接続する時にOpenClient Libraryのデフォルトのパスワード暗号化を使用するように指定するには、このチェックボックスをオンにします。

これらのプロパティは、[Location Options] (ロケーションオプション)チェックボックスがオンの場合にのみ使用できます。

[Use TDS Packet Size] (TDSパケットサイズを使用する)

このチェックボックスをオンにして、表示される[Packet Size] (パケットサイズ)フィールドで、TDSパケットサイズをバイト単位で指定します。

これらのプロパティは、[Location Options] (ロケーションオプション)チェックボックスがオンの場合にのみ使用できます。

[Quoted Identifier] (クォートを付けた識別子)

このチェックボックスをオンにして、表示される[Status] (ステータス)ドロップダウンリストから、リモートサーバーにQUOTED_IDENTIFIERオプションの設定を指定します。

これらのプロパティは、[Location Options] (ロケーションオプション)チェックボックスがオンの場合にのみ使用できます。

[Set Isolation Level] (分離レベルの設定)

このチェックボックスをオンにして、表示される[Isolation Level] (分離レベル)ドロップダウンリストから、リモートサーバーへの接続の分離レベルを選択します。

これらのプロパティは、[Location Options] (ロケーションオプション)チェックボックスがオンの場合にのみ使用できます。

[Insert Load Options] (ロード挿入オプション)

ロード挿入オプションを表示するには、このチェックボックスをオンにします。ロード挿入オプションの詳細は、http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.infocenter.dc00801.1510/html/iqrefso/X315746.htmをご覧ください。

これらのプロパティは、[Use Insert-Location] (挿入ロケーションの使用)チェックボックスがオンの場合にのみ使用できます。

[Limit Number] (数の制限)

Sybase IQテーブルに挿入する最大行数を指定します。

これらのプロパティは、[Insert Load Options] (ロード挿入オプション)チェックボックスがオンの場合にのみ使用できます。

[Notify Number] (番号の通知)

行数がSybaseIQテーブルに正常に挿入されるたびにメッセージが通知されるように指定します。

これらのプロパティは、[Insert Load Options] (ロード挿入オプション)チェックボックスがオンの場合にのみ使用できます。

[Skip Number] (スキップ数)

ソーステーブルの先頭でスキップする行数を指定します。

これらのプロパティは、[Insert Load Options] (ロード挿入オプション)チェックボックスがオンの場合にのみ使用できます。

[Start Row ID] (開始行ID)

挿入を開始するSybaseIQテーブルの行のIDを指定します。

注: Sybase IQ 16はこのパラメーターをサポートしていません。

これらのプロパティは、[Insert Load Options] (ロード挿入オプション)チェックボックスがオンの場合にのみ使用できます。

[Insert Select Load Options] (選択ロード挿入オプション)

選択ロード挿入オプションを表示するには、このチェックボックスをオンにします。選択ロード挿入オプションの詳細は、http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.infocenter.dc00801.1510/html/iqrefso/X315750.htmをご覧ください。

これらのプロパティは、[Use Insert-Location] (挿入ロケーションの使用)チェックボックスがオンの場合にのみ使用できます。

[Word Skip Number] (ワードスキップ数)

Sybase IQテーブルにデータをロードするときに、 サポートされていない最大許容ワード長を超えるエラーワードが無視される回数を入力します。

これらのプロパティは、[Insert Select Load Options] (選択ロード挿入オプション)チェックボックスがオンの場合にのみ使用できます。

[Ignore Constraint] (制約を無視)

このチェックボックスをオンにすると、表示されるテーブルで、Sybase IQテーブルにデータをロードする時に無視する整合性制約違反を指定できます。[+]ボタンをクリックして、必要な数の行を追加し、各行を制約違反に追加し、各制約違反に次のカラムの値を設定するために使われます。

  • [Constraint Type] (制約タイプ): セルをクリックし、表示されたドロップダウンリストから、無視する制約違反のタイプを選択します。

  • [Number] (数): ロード中にロールバックを開始する前に無視する制約違反の最大数を入力します。

これらのプロパティは、[Insert Select Load Options] (選択ロード挿入オプション)チェックボックスがオンの場合にのみ使用できます。

[Log In file] (ログインファイル)

制約違反情報をファイルに記録する場合は、このチェックボックスをオンにします。

これらのプロパティは、[Insert Select Load Options] (選択ロード挿入オプション)チェックボックスがオンの場合にのみ使用できます。

[Message Log] (メッセージログ)

MESSAGELOGファイルへのパスを指定します。

これらのプロパティは、[Log In File] (ログインファイル)チェックボックスがオンの場合にのみ使用できます。

[Row Log] (行ログ)

ROW LOGファイルへのパスを指定します。

これらのプロパティは、[Log In File] (ログインファイル)チェックボックスがオンの場合にのみ使用できます。

[Log Delimited By] (ログの区切り)

ROW LOGファイルのデータ値間の区切りを指定します。

これらのプロパティは、[Log In File] (ログインファイル)チェックボックスがオンの場合にのみ使用できます。

[Log Filter] (ログフィルター)

このチェックボックスをオンにして、表示される[Only Log] (ログのみ)ドロップダウンリストから、ログに記録する制約違反情報のタイプを選択します。

これらのプロパティは、[Log In File] (ログインファイル)チェックボックスがオンの場合にのみ使用できます。

[tStatCatcher Statistics] (tStatCatcher統計)

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

使用方法

[Dynamic settings] (ダイナミック設定)

[+]ボタンをクリックしてテーブルに行を追加し、[Code] (コード)フィールドにコンテキスト変数を入力して、ジョブ内で計画した複数の接続からデータベース接続をダイナミックに選択します。この機能は、データストラクチャーが同じでデータベースが異なるデータベーステーブルにアクセスする必要がある場合、特に、Talend Studioを介さずにジョブをデプロイおよび実行する必要がある時など、ジョブの設定を変更できない環境で作業している場合に役立ちます。

[Dynamic settings] (ダイナミック設定)テーブルは、[Basic settings] (基本設定)ビューで[Use an existing connection] (既存の接続を使用)チェックボックスがオンになっている場合のみ利用できます。ダイナミックパラメーターを定義すると、[Basic settings] (基本設定)ビューの[Component List] (コンポーネントリスト)ボックスは利用できなくなります。

ダイナミックパラメーターの定義法を示すユースケースについては、コンテキストベースのダイナミック接続によってデータベースからデータを読み取りと、ダイナミックにロードされた接続パラメーターを使って異なるMySQLデータベースからデータを読み取りをご覧ください。ダイナミック設定とコンテキスト変数の詳細は、ダイナミックスキーマコンテキストグループを作成し、その中でコンテキスト変数を定義をご覧ください。