# tImpalaCreateTable

さまざまなImpalaデータ形式に合うImpalaテーブルを作成します。

tImpalaCreateTableは、使用するImpalaデータベースに接続し、指定する形式のデータを専用とするImpalaテーブルを作成します。

デフォルトで、このコンポーネントはTalend Studioと共には出荷されていません。機能マネージャーを使ってインストールする必要があります。 詳細は、[機能マネージャーを使って機能をインストール](https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/install-features-to-talend-studio)をご覧ください。

## tImpalaCreateTableの標準プロパティ

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

標準のtImpalaCreateTableコンポーネントは、ビッグデータファミリーに属しています。

このフレームワークのコンポーネントは、すべてのビッグデータ対応のTalend製品およびTalend Data Fabricで利用できます。

## 基本設定

| プロパティ | 説明 |
| --- | --- |
| [Property type] (プロパティタイプ) | 接続の詳細の保存方法を選択します。<br><br><ul> <li> <span>[Built-in] (組み込み)</span>: 一元的に保存されるプロパティデータはありません。</li> <li> <span>[Repository] (リポジトリー)</span>: プロパティが保管されるリポジトリーファイルを選択します。後続フィールドは、取得されたデータを使用して自動的に入力されます。</li> </ul> |
| [Use an existing connection] (既存の接続を使用) | 定義済みの接続の詳細を再利用する場合は、このチェックボックスを選択して、[Component List] (コンポーネントリスト)ドロップダウンリストから、目的の接続コンポーネントを選択します。<br><br>情報メモ注: ジョブに親ジョブと子ジョブが含まれている時は、親ジョブと子ジョブの間の既存の接続を共有したい場合(たとえば、親ジョブで作成した接続を子ジョブと共有するなど)には、次のように実行します。<br><br><ol> <li>親レベルで、共有するデータベース接続を、そのデータベース接続そのものを作成する接続コンポーネントの<span>[Basic settings] (基本設定)</span>ビューに登録します。 </li> <li>子レベルで、登録済みのそのデータベース接続を読み取るために専用の接続コンポーネントを使用します。 </li> </ol><br><br>ジョブレベル全体でデータベース接続を共有する方法の例は、[データベース接続を共有](https://help.qlik.com/talend/r/ja-JP/7.3/studio-user-guide/sharing-database-connection)をご覧ください。 |
| [Impala Driver] (Impalaドライバー) | ドロップダウンリストから使用しているドライバーを選択します。 |
| [Host] (ホスト) | データベースサーバーのIPアドレスを入力します。 |
| [Port] (ポート) | データベースサーバーのリスニングポート番号を入力します。 |
| [Database] (データベース) | データベースの名前を入力します。 |
| [Additional JDBC Settings] (追加のJDBC設定) | 作成するデータベース接続に接続の追加プロパティを指定します。<br><br>このオプションは、[Basic settings] (基本設定)ビューの[Use an existing connection] (既存の接続を使用)チェックボックスがオンになっている場合は利用できません。 |
| [Username] (ユーザー名)と[Password] (パスワード) | LDAPを使って認証するデータベースユーザー認証データを入力します。<br><br>パスワードを入力するには、パスワードフィールドの横にある[...]ボタンをクリックし、ポップアップダイアログボックスにパスワードを二重引用符の間に入力し、[OK] をクリックして設定を保存します。<br><br>これらのパラメーターは、[Use kerberos authentication] (Kerberos認証を使用)チェックボックスを選択した場合は使用できません。 |
| [Use Kerberos authentication] (Kerberos認証を使用) | Kerberosセキュリティを実行しているImpalaシステムにアクセスする場合は、このチェックボックスを選択し、このImpalaシステムのKerberosプリンシパルを入力します。 |
| [Schema] (スキーマ)と[Edit schema] (スキーマを編集) | スキーマとは行の説明のことです。処理して次のコンポーネントに渡すフィールド(カラム)数を定義します。Sparkジョブを作成する場合、フィールドの命名時は予約語のlineを避けます。<br><br>[Built-in] (組み込み): そのコンポーネントに対してのみスキーマを作成し、ローカルに保管します。<br><br>[Repository] (リポジトリー): スキーマは作成済みで、リポジトリーに保管されています。さまざまなプロジェクトやジョブデザインで再利用できます。<br><br>再利用するスキーマに整数またはファンクションのデフォルト値が指定されている場合は、これらのデフォルト値を引用符で囲まないようにご注意ください。引用符で囲まれている場合は手動で削除します。<br><br>スキーマを変更するには[Edit schema] (スキーマを編集)をクリックします。現在のスキーマがリポジトリータイプの場合は、3つのオプションを利用できます。<br><br><ul> <li> <p> <span>[View schema] (スキーマを表示)</span>: スキーマのみを表示する場合は、このオプションを選択します。</p> </li> <li> <p> <span>[Change to built-in property] (組み込みのプロパティに変更)</span>: ローカルで変更を行うためにスキーマを<span>組み込み</span>に変更する場合は、このオプションを選択します。</p> </li> <li> <p> <span>[Update repository connection] (リポジトリー接続をアップデート)</span>: リポジトリーに保存されているスキーマに変更を加え、変更後にそのコンテンツをすべてのジョブにプロパゲートするかどうかを決める場合は、このオプションを選択します。</p> <p>変更を現在のジョブにのみ反映する場合は、変更後、<span>[No] (いいえ)</span>を選択し、<span>[Repository Content] (リポジトリーコンテンツ)</span>ウィンドウで再びこのスキーマのメタデータを選択します。</p> </li> </ul> |
| [Table Name] (テーブル名) | 作成するテーブルの名前を入力します。 |
| [Action on table] (テーブルでのアクション) | テーブル作成のためのアクションを選択します。<br><br><ul> <li> <span>[Create table] (テーブルを作成)</span>: テーブルが作成されます。</li> <li> <span>[Create table if not exists] (テーブルが存在しない場合は作成)</span>: テーブルが存在しない場合は作成されます。</li> </ul> |
| [Format] (形式) | 作成するテーブルの専用データ形式を選択します。<br><br><ul> <li> <span>TEXTFILE</span> </li> <li> <span>SEQUENCEFILE</span> </li> <li> <span>RCFILE</span> </li> <li> <span>PARQUET</span> </li> <li> <span>AVRO</span> </li> <li> <span>KUDU</span> (Kudu形式は、<span>Talend</span>が提供する8.0.1 R2023-02以降の<span>Talend Studio</span>マンスリーアップデートをインストール済みである場合のみ利用できます)</li> </ul><br><br>使用するファイル形式が[PARQUET]である場合は、特定のPARQUET JARファイルを検索してTalend Studioにインストールするように指示するプロンプトが表示されることがあります。<br><br><ul> <li> <p>Hiveへの接続モードが<span>[Embedded] (組み込み)</span>の場合、ジョブはローカルマシンで実行され、<span>Talend Studio</span>にインストールされているこのJARを呼び出します。</p> </li> <li> <p>Hiveへの接続モードが<span>[Standalone] (スタンドアロン)</span>の場合、ジョブはHiveをホストするサーバーで実行され、このJARファイルは接続先のクラスターのHDFSシステムに送信されます。したがって、<span>[Basic settings] (基本設定)</span>ビューの対応するフィールドでNameNode URIが正しく定義されていることをご確認ください。</p> </li> </ul><br><br><br>このJARファイルはApacheのサイトからダウンロードできます。外部モジュールのインストール方法は、[外部モジュールをインストール](https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/installing-external-modules)をご覧ください。 |
| パーティションの設定 | 作成するテーブルにパーティションカラムを追加するには、このチェックボックスをオンにします。選択したら、追加する必要のあるパーティションカラムのスキーマを定義する必要があります。<br><br>[Format] (形式)ドロップダウンリストでKUDUを選択すれば、[Kudu partition] (Kuduパーティション)というパラメーターで作成sされるパーティションの数を設定できます。デフォルト値はHASH PARTITIONS 3です。詳細は、Kuduのドキュメンテーションで[Partitioning tables](https://kudu.apache.org/docs/kudu_impala_integration.html#partitioning_tables)をご覧ください。 |
| [Set file location] (ファイルのロケーションの設定) | デフォルト以外のディレクトリーにImpalaテーブルを作成する場合は、このチェックボックスをオンにして、テーブルのコンテンツを保持するために使用するディレクトリーをHDFSに入力します。<br><br>これは通常、[Advanced settings] (詳細設定)タブの[Create an external table] (外部テーブルを作成する)チェックボックスをオンにして外部Impalaテーブルを作成する必要がある場合に役立ちます。 |
| [Use S3 endpoint] (S3エンドポイントを使用) | [Set file location] (ファイルのロケーションを設定する)チェックボックスをオンにして、外部Impalaテーブルを作成すると、[Use S3 endpoint] (S3エンドポイントを使用)チェックボックスが表示されます。<br><br>この[Use S3 endpoint] (S3エンドポイントを使用)チェックボックスをオンにしたら、表示されたフィールドに次のパラメーターを入力する必要があります。<br><br><ul> <li> <p> <span>[S3 bucket] (S3バケット)</span>: テーブルを作成するバケットの名前を入力します。</p> </li> <li> <span>[Bucket name] (バケット名)</span>: ジョブの依存項目を保存するために使用するバケットの名前を入力します。S3に既存のバケットを用意しておく必要があります。</li> <li> <span>[Temporary resource folder] (一時リソースフォルダー)</span>: ジョブの依存項目を保存するディレクトリーを入力します。たとえば、バケット内の<span>/temp_resources</span> フォルダーに依存項目を書き込むには、<span>temp_resources</span>と入力します。<p>ランタイムにこのフォルダーが既に存在する場合、そのコンテンツは新しい依存項目によって上書きされます。そうでない場合、このフォルダーは自動的に作成されます。</p> </li> <li> <p> <span>[Access key] (アクセスキー)</span>と<span>[Secret key] (シークレットキー)</span>: 使用するAmazon S3バケットへの接続に必要な認証情報を入力します。 </p> <p>パスワードを入力するためには、パスワードフィールドの横にある<span>[...]</span>ボタンをクリックし、ポップアップダイアログボックスにパスワードを二重引用符で囲んで入力して<span>[OK]</span>をクリックし、設定を保存します。</p> </li> </ul><br><br><br>S3ファイルの形式はS3N (S3ネイティブファイルシステム)です。<br><br>S3で作成されたImpalaテーブルは実際には外部テーブルであるため、この[Use S3 endpoint] (S3エンドポイントを使用)チェックボックスは、[Create an external table] (外部テーブルの作成)が選択された状態で使用する必要があります。 |

## 詳細設定

| プロパティ | 説明 |
| --- | --- |
| [Like table] (テーブルのように) | このチェックボックスをオンにし、コピーするImpalaテーブルの名前を入力します。これにより、データをコピーせずに既存のテーブルの定義をコピーできます。 |
| 外部テーブルの作成 | このチェックボックスをオンにすると、作成するテーブルが外部Impalaテーブルになります。この種のImpalaテーブルは、データがHDFSにある場合、生データをそのまま残します。<br><br>通常、ファイルシステムに存在する共有データにアクセスするには、外部テーブルの方が適しています。 |
| [Table comment] (テーブルコメント) | 作成するテーブルに使用する説明を入力します。 |
| [As select] (選択として) | このチェックボックスをオンにして、Selectステートメントに基づくImpalaテーブルを作成するためのAs selectステートメントを入力します 。 |
| [Table properties] (テーブルのプロパティ) | Talend StudioのHadoopエンジンで使用されるデフォルトのプロパティをオーバーライドするカスタムImpalaテーブルプロパティを追加します。 |
| [tStatCatcher Statistics] (tStatCatcher統計) | このチェックボックスを選択すると、コンポーネントレベルでログデータを収集できます。 |

## グローバル変数

| 変数 | 説明 |
| --- | --- |
| グローバル変数 | ERROR\_MESSAGE: エラーが発生した時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。この変数はコンポーネントにこのチェックボックスが存在し、[Die on error] (エラー発生時に強制終了)がオフになっている場合のみ機能します。<br><br>Flow変数はのコンポーネントの実行中に機能し、After変数はコンポーネントの実行後に機能します。<br><br>フィールドまたは式に変数を入力する場合は、Ctrl + スペースを押して変数リストにアクセスし、使用する変数を選択します。<br><br>変数の詳細は、[コンテキストと変数を使用](https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/contexts-and-variables)をご覧ください。 |

## 使用方法

| 使用方法のガイダンス | 説明 |
| --- | --- |
| **使用ルール** | このコンポーネントは、スタンドアロンとして機能します。 |