# tHCatalogOperation (非推奨)

Availability-note[非推奨](https://help.talend.com/r/en-US/Cloud/labels-on-talend-help-center/availability-deprecated)

このコンテンツは非推奨になりました。

情報メモDeprecated: 8.0.1-R2024-08のリリース以降、このコンポーネントは非推奨になっています。

処理するHCatalog管理対象データベース/テーブル/パーティションを準備します。

tHCatalogOperationは、HCatalog管理対象Hiveデータベース/テーブル/パーティションに保存されたデータを管理します。

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

## tHCatalogOperationの標準プロパティ

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

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

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

## 基本設定

| プロパティ | 説明 |
| --- | --- |
| [Property type] (プロパティタイプ) | [Built-in] (組み込み)と[Repository] (リポジトリー)のいずれかです。<br><br>[Built-in] (組み込み): 一元的に保存されるプロパティデータはありません。<br><br>[Repository] (リポジトリー): プロパティが保管されるリポジトリーファイルを選択します。後続フィールドは、取得されたデータを使用して自動的に入力されます。 |
| [Distribution] (ディストリビューション) | ドロップダウンリストから、使用するクラスターを選択します。リストのオプションは使用するコンポーネントによって異なります。これらのオプションの中でも、以下のオプションを使用するには特定の設定が必要です。<br><br><ul> <li> <p>この<span>[Distribution] (ディストリビューション)</span>ドロップダウンリストに<span>[Microsoft HD Insight]</span>オプションが表示されている場合は、Microsoft HD Insightクラスターを利用できます。この場合、表示されているエリアでクラスターのHD Insightクラスター、Windows Azure Storageサービスへの接続を設定する必要があります。これらのパラメーターの詳細は、<a href="https://help.qlik.com/talend/r/ja-JP/7.3/studio-user-guide/configuring-connection-manually" target="_blank">手動で接続を設定</a>をご覧ください。 </p> </li> <li> <p><span>Amazon EMR</span>を選択している場合は、<a href="https://help.qlik.com/talend/r/en-US/8.0/amazon-emr-getting-started" target="_blank">Amazon EMR - Getting Started</a>で詳細をご覧ください。</p> </li> <li> <p><span>[Custom] (カスタム)</span>オプションを使用すれば、リストにあるディストリビューションのものとは異なるクラスター、つまり、<span> <span>Talend</span> </span>で正式にサポートされていないクラスターに接続できます。</p> </li> </ul><br><br><ol> <li> <p><span>[Import from existing version] (既存のバージョンからインポート)</span>を選択すると、正式にサポートされているディストリビューションをベースとしてインポートしてから、ベースディストリビューションで提供されていない他の必要なjarファイルを追加できます。</p> </li> <li> <p><span>[Import from zip] (zipからインポート)</span>を選択すると、使用するカスタムディストリビューションの設定zipファイルをインポートできます。zipファイルには、Hadoopの各種エレメントのライブラリーおよびこれらのライブラリーのインデックスファイルが含まれている必要があります。 </p> <p><span><span>Talend</span></span>はカスタムバージョンを公式にサポートしていません。<span><span>Talend</span></span>とそのコミュニティでは、<span>Talend Studio</span>からカスタムバージョンに接続するための方法を紹介していますが、Hadoopのディストリビューションとバージョンの種類は幅広いため、選択したバージョンの設定がスムーズに機能するかどうかは保証できません。そのような接続のセットアップは、Hadoopについてどんな問題でもご自身で対処できる十分な経験をお持ちの場合のみ行ってください。</p> <div><span>情報メモ</span><span>注:</span> <p>カスタムディストリビューションとこのコンポーネント間で作成する接続に関わるjarファイルがインポートされるように、このダイアログボックスのアクティブなチェックボックスをオフにしないでください。</p> </div> <p>カスタムディストリビューションの接続方法、および接続の共有方法のステップ例は、<a href="https://help.qlik.com/talend/r/ja-JP/8.0/hortonworks" target="_blank">Hortonworks</a>をご覧ください。</p> </li> </ol> |
| HCatalog version (HCatalogバージョン) | 使用しているディストリビューションのHBaseバージョンを選択します。 |
| Templeton hostname (Templetonのホスト名) | このフィールドにTempleton WebserviceのURLを入力します。<br><br>情報メモ注:<br><br>Templetonは、HCatalog用のWebサービスAPIです。Apacheコミュニティによって名前がWebHCatに変更されています。このサービスにより、HCatalogおよび関連するHadoopエレメント(Pigなど)へのアクセスが容易になります。Templeton (WebHCat)の詳細は、https://cwiki.apache.org/confluence/display/Hive/WebHCat+UsingWebHCatをご覧ください。 |
| Templeton port (Templetonのポート) | このフィールドにTempleton WebserviceのURLのポートを入力します。このフィールドのデフォルト値は*50111*です。<br><br>情報メモ注:<br><br>Templetonは、HCatalog用のWebサービスAPIです。Apacheコミュニティによって名前がWebHCatに変更されています。このサービスにより、HCatalogおよび関連するHadoopエレメント(Pigなど)へのアクセスが容易になります。Templeton (WebHCat)の詳細は、https://cwiki.apache.org/confluence/display/Hive/WebHCat+UsingWebHCatをご覧ください。 |
| [Use Kerberos authentication] (Kerberos認証を使用) | Kerberosセキュリティを実行しているHadoopクラスターにアクセスする場合は、このチェックボックスを選択し、表示されるフィールドにネームノードとしてKerberosのプリンシパル名を入力します。これにより、ユーザー名を使って、Kerberosに保存された認証情報に対して認証を実行できます。<br><br>接続しているHadoopのディストリビューションによってはこのチェックボックスが表示されないこともあります。 |
| [Use a keytab to authenticate] (Keytabを認証に使用) | [Use a keytab to authenticate] (Keytabを認証に使用)チェックボックスをオンにして、所定のkeytabファイルを使ってKerberos対応のシステムにログインします。keytabファイルには、Kerberosのプリンシパルと暗号化されたキーのペアが含まれています。使用するプリンシパルを[Principal] (プリンシパル)フィールドに入力し、keytabファイルへのアクセスパスを[Keytab] フィールドに入力します。このキータブファイルは、ジョブが実際に実行されているマシン(Talend JobServerなど)に保存する必要があります。<br><br>keytabが有効なジョブは、プリンシパルに任命されたユーザーでなくても実行できますが、使用するkeytabファイルの読み取り権限が必要です。たとえば*user1*というユーザー名でジョブを実行し、使用するプリンシパルが*guest*の場合、*user1*に使用するキータブファイルの読み取り権限があることをご確認ください。 |
| 操作 | DB操作のリストから次のオブジェクトを選択します。<br><br>Database (データベース): HDFSのHCatalog管理対象データベース。<br><br>Table (テーブル): HDFSのHCatalog管理対象テーブル。<br><br>Partition (パーティション): ユーザーが指定したパーティション。 |
| オペレーション | DB操作のリストから操作を選択します。HDFSでのDB操作の詳細は、https://cwiki.apache.org/Hive/をご覧ください。 |
| Create the table only it doesn't exist already (まだ作成していない場合にだけテーブルを作成する) | テーブルを作成する際、重複して作成するのを避けるためにこのチェックボックスをオンにしてください。<br><br>情報メモ注:<br><br>このチェックボックスは、[Operation on] (操作)リストから[Table] (テーブル)を選択した場合にしか有効になりません。 |
| データベース | このフィールドには、HCatalog管理対象テーブルを配置するデータベースの名前を入力します。 |
| [Table] (テーブル) | このフィールドには、操作を行うデータベースの1つ以上のテーブルまたは指定のHDFSの場所を入力します。<br><br>情報メモ注:<br><br>このフィールドは、[Operation on] (操作)リストから[Table] (テーブル)を選択した場合にのみ有効になります。テーブルへの操作の詳細は、https://cwiki.apache.org/Hive/をご覧ください。 |
| Partition (パーティション) | このフィールドでは、指定したテーブルでのパーティション操作対象のパーティションを1つ以上指定します。複数のパーティションを指定する場合は、コンマを使って2つ置きにパーティションを区切り、二重引用符を使ってパーティション文字列を囲みます。<br><br>パーティショニングされていないテーブルを読み取る場合は、このフィールドを空にしておきます。<br><br>情報メモ注:<br><br>このフィールドは、[Operation on] (操作)リストから[Partition] (パーティション)を選択した場合にのみ有効になります。パーティションへの操作の詳細は、https://cwiki.apache.org/Hive/をご覧ください。 |
| [Username] (ユーザー名) | このフィールドには、DB認証用のユーザー名を入力します。 |
| Database location (データベースの場所) | このフィールドには、HDFSのデータベースファイルのロケーションを入力します。<br><br>情報メモ注:<br><br>このフィールドは、[Operation on] (操作)リストから[Database] (データベース)を選択した場合にのみ有効になります。 |
| Database description (データベースの説明) | 作成するデータベースの説明です。<br><br>情報メモ注:<br><br>このフィールドは、[Operation on] (操作)リストから[Database] (データベース)を選択した場合にのみ有効になります。 |
| 外部テーブルの作成 | [Advanced settings] (詳細設定)ビューの[Set HDFS location] (HDFSの場所を設定)フィールドで定義した代替パス内に外部テーブルを作成する場合は、このフィールドをオンにします。外部テーブル作成の詳細は、https://cwiki.apache.org/Hive/をご覧ください。<br><br>情報メモ注:<br><br>[Operation on] (操作)リストから[Table] (テーブル)を選択し、[Operation] (操作)リストから[Create] (作成) / [Drop and create] (ドロップおよび作成) / [Drop if exist and create] (存在する場合はドロップして作成)を選択した場合にしか、このチェックボックスは有効になりません。 |
| 形式 | リストからファイル形式を選択して、作成する外部テーブルの形式を指定します。<br><br>TEXTFILE: テキスト形式ファイル。<br><br>RCFILE: Record Columnarファイル。RCFILEの詳細は、https://cwiki.apache.org/confluence/display/Hive/RCFileをご覧ください。<br><br>情報メモ注:<br><br>RCFILEは、Hive 0.6.0以上でしか使用できません。[Operation on] (操作)リストから[Table] (テーブル)を選択し、[Operation] (操作)リストから[Create] (作成) / [Drop and create] (ドロップおよび作成) / [Drop if exist and create] (存在する場合はドロップして作成)を選択した場合にしか、このリストは有効になりません。 |
| パーティションの設定 | <ul> <li> <p><span>[Set partitions] (パーティションの設定)</span>チェックボックスの右の<span>[Edit schema] (スキーマを編集)</span>をクリックしてパーティションスキーマを設定する場合は、このチェックボックスをオンにします。パーティションスキーマが組み込まれるか、リポジトリーにリモートで保存されます。 </p> <div><span>情報メモ</span><span>注:</span> <p><span>[Operation on] (操作)</span>リストから<span>[Table] (テーブル)</span>を選択し、<span>[Operation] (操作)</span>リストから<span>[Create] (作成)</span> / <span>[Drop and create] (ドロップおよび作成)</span> / <span>[Drop if exist and create] (存在する場合はドロップして作成)</span>を選択した場合にしか、このチェックボックスは有効になりません。HCatalog管理対象テーブルのパーティションスキーマの使用ルールに従ってください。パーティションスキーマの使用ルールの詳細は、<a href="https://cwiki.apache.org/confluence/display/Hive/HCatalog" target="_blank">https://cwiki.apache.org/confluence/display/Hive/HCatalog</a>をご覧ください。</p> </div> </li> <li> <p> <span>[Built-in] (組み込み)</span>: このコンポーネントに対してのみ作成されたスキーマがローカルに保管されます。<span>[Basic settings] (基本設定)</span>タブにあるコンポーネントスキーマの詳細は、<a href="https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/basic-settings-tab" target="_blank">[Basic settings] (基本設定)</a>をご覧ください。</p> </li> <li> <p> <span>[Repository] (リポジトリー)</span>: 既存のスキーマがリポジトリーに保管されているので、さまざまなプロジェクトやジョブデザインで再利用できます。<span>[Basic settings] (基本設定)</span>タブにあるコンポーネントスキーマの詳細は、<a href="https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/basic-settings-tab" target="_blank">[Basic settings] (基本設定)</a>をご覧ください。</p> </li> </ul> |
| Set the user group to use (使用するユーザーグループを設定する) | このチェックボックスをオンにすると、ユーザーグループを指定できます。<br><br>情報メモ注:<br><br>[Operation] (操作)リストから[Drop] (ドロップ) / [Drop if exist] (存在する場合はドロップ) / [Drop and create] (ドロップおよび作成) / [Drop if exist and create] (存在する場合はドロップして作成)を選択しないと、このチェックボックスは有効になりません。このフィールドのデフォルト値は*root*です。サーバーのユーザーグループの詳細は、システム管理者にお問い合わせください。 |
| オプション | データベースをドロップする時に句を選択してください。<br><br>情報メモ注:<br><br>[Operation on] (操作)リストから[Database] (データベース)を選択し、[Operation] (操作)リストから[Drop] (ドロップ) / [Drop if exist] (存在する場合はドロップ) / [Drop and create] (ドロップおよび作成) / [Drop if exist and create] (存在する場合はドロップして作成)を選択した場合にのみ、このリストは有効になります。データベースへのドロップ操作 の詳細は、https://cwiki.apache.org/Hive/をご覧ください。 |
| Set the permissions to use (使用権限を設定する) | [Operation] (操作)リストから選択した操作に必要な権限を指定する場合、このチェックボックスをオンにします。<br><br>情報メモ注:<br><br>[Operation] (操作)リストから[Drop] (ドロップ) / [Drop if exist] (存在する場合はドロップ) / [Drop and create] (ドロップおよび作成) / [Drop if exist and create] (存在する場合はドロップして作成)を選択しないと、このチェックボックスは有効になりません。このフィールドのデフォルト値は*rwxrw-r-x*です。ユーザー権限の詳細は、システム管理者にお問い合わせください。 |
| Set File location (ファイルのロケーションの設定) | パーティションデータが保存されているディレクトリーを入力します。<br><br>情報メモ注:<br><br>[Operation on] (操作)リストから[Partition] (パーティション)を選択し、[Operation] (操作)リストから[Create] (作成) / [Drop and create] (ドロップおよび作成) / [Drop if exist and create] (存在する場合はドロップして作成)を選択した場合にしか、このチェックボックスは有効になりません。HDFSへのパーティションデータの保存については、https://cwiki.apache.org/Hive/をご覧ください。 |
| Die on error (エラー発生時に強制終了) | このチェックボックスはデフォルトでオフになっています。すなわち、エラーが発生した行をスキップし、エラーが発生していない行のプロセスを完了させます。 |

## 詳細設定

| プロパティ | 説明 |
| --- | --- |
| Comment | 作成するテーブルに関するコメントをこのフィールドに入力します。<br><br>情報メモ注:<br><br>[Operation on] (操作)リストから[Table] (テーブル)を選択し、[Basic settings view] (基本設定ビュー)の[Operation] (操作)リストから[Create] (作成) / [Drop and create] (ドロップおよび作成) / [Drop if exist and create] (存在する場合はドロップして作成)を選択した場合にのみ、このフィールドは有効になります。 |
| Set HDFS location (HDFSロケーションの設定) | 作成したテーブルを保存するHDFSの場所を指定する場合、このチェックボックスをオンにします。作成するテーブルを、Hive設定ファイル*hive-site.xml*にのキー*hive.metastore.warehouse.dir*で定義したウェアハウスディレクトリーに保存する場合は、このチェックボックスをオフにします。<br><br>情報メモ注:<br><br>[Operation on] (操作)リストから[Table] (テーブル)を選択し、[Basic settings view] (基本設定ビュー)の[Operation] (操作)リストから[Create] (作成) / [Drop and create] (ドロップおよび作成) / [Drop if exist and create] (存在する場合はドロップして作成)を選択した場合にしか、このチェックボックスは有効になりません。HDFSへのデータ保存の詳細は、https://cwiki.apache.org/Hive/をご覧ください。 |
| Set row format(terminated by) (行形式を設定する(以下で終了)) | テーブルを作成する際、行形式を使用し、定義する場合にこのチェックボックスをオンにします。<br><br>[Field] (フィールド): フィールドを行形式として使用する場合はこのチェックボックスをオンにします。このフィールドのデフォルト値は*"\u0001"*です。このフィールドでは、カスタマイズした文字も指定できます。<br><br>[Collection Item] (コレクション項目): コレクション項目を行形式として使用する場合はこのチェックボックスをオンにします。このフィールドのデフォルト値は*"\u0002"*です。このフィールドでは、カスタマイズした文字も指定できます。<br><br>[Map Key] (マップキー): マップキーを行形式として使用する場合はこのチェックボックスをオンにします。このフィールドのデフォルト値は*"\u0003"*です。このフィールドでは、カスタマイズした文字も指定できます。<br><br>[Line] (行): 行を行形式として使用する場合はこのチェックボックスをオンにします。このフィールドのデフォルト値は*"\n"*です。このフィールドでは、カスタマイズした文字も指定できます。<br><br>情報メモ注:<br><br>[Operation on] (操作)リストから[Table] (テーブル)を選択し、[Basic settings view] (基本設定ビュー)の[Operation] (操作)リストから[Create] (作成) / [Drop and create] (ドロップおよび作成) / [Drop if exist and create] (存在する場合はドロップして作成)を選択した場合にしか、このチェックボックスは有効になりません。HCatalog管理対象テーブルの行形式の詳細は、https://cwiki.apache.org/Hive/をご覧ください。 |
| プロパティ | [+]をクリックして、1つ以上の行を追加してテーブルプロパティを定義します。テーブルプロパティを使用すると、ユーザー独自のメタデータのキー/値ペアでテーブルの定義をタグ付けできます。キーの行と値の行双方の値を必ず二重引用符で囲んでください。<br><br>情報メモ注:<br><br>[Operation on] (操作)リストから[Database] (データベース) / [Table] (テーブル)を選択し、[Basic settings view] (基本設定ビュー)の[Operation] (操作)リストから[Create] (作成) / [Drop and create] (ドロップおよび作成) / [Drop if exist and create] (存在する場合はドロップして作成)を選択した場合にのみ、このテーブルは有効になります。テーブルプロパティの詳細は、https://cwiki.apache.org/Hive/をご覧ください。 |
| Retrieve the HCatalog logs (HCatalogログを取得する) | HCatalogの操作中に生成されたログファイルを取得するには、このチェックボックスをオンにします。 |
| [Standard Output Folder] (標準出力フォルダー) | ログファイルを保存するディレクトリーを参照または入力します。<br><br>情報メモ注:<br><br>[Retrieve the HCatalog logs] (HCatalogログを取得する)チェックボックスをオンにしないと、このフィールドは有効になりません。 |
| エラー出力フォルダー | エラーログファイルを保存するディレクトリーを参照または入力します。<br><br>情報メモ注:<br><br>[Retrieve the HCatalog logs] (HCatalogログを取得する)チェックボックスをオンにしないと、このフィールドは有効になりません。 |
| [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)をご覧ください。 |

## 使用方法

| 使用方法のガイダンス | 説明 |
| --- | --- |
| **使用ルール** | このコンポーネントは、単一コンポーネントサブジョブで共通して使用されます。<br><br>HCatalogはHiveメタストアの上にビルドされ、PigとMapReduceに読み取りと書き込みのインターフェイスを提供します。これは、後者のシステムがHiveのメタデータを使用して、HDFS内のデータの読み書きを容易に行うことができるようにするためです。<br><br>詳細は、ApacheのドキュメンテーションでHCatalogに関する説明(https://cwiki.apache.org/confluence/display/Hive/HCatalog)をご覧ください。 |
| 前提条件 | *Talend Studio* との操作を確実に行うには、Hadoopディストリビューションを適切にインストールする必要があります。以下のリストに、MapR関連の情報などを示します。<br><br><ul> <li> <p>MapRクライアントは必ず<span>Talend Studio</span>のあるマシンにインストールして、そのマシンのPATH変数にMapRクライアントライブラリーを追加します。MapRのドキュメンテーションによると、各OSバージョンに対応するMapRクライアントのライブラリーは、<em>MAPR_INSTALL\ hadoop\hadoop-VERSION\lib\native</em>にあります。たとえば、Windows版のライブラリーは、<em>\lib\native\MapRClient.dll</em>にあるMapRクライアントのjarファイルにあります。</p> <p>指定のライブラリーを追加しないと、<span>no MapRClient in java.library.path</span>というエラーが発生する可能性があります。</p> </li> <li> <p>たとえば、<span>[Window] (ウィンドウ)</span>メニューの<span>[Preferences] (環境設定)</span>ダイアログボックスにある<span>[Run/Debug] (実行/デバッグ)</span>ビューの<span>[Job Run VM arguments] (ジョブ実行VMの引数)</span>エリアで、<span>-Djava.library.path</span>引数を設定します。この引数により、そのMapRクライアントのネイティブライブラリーへのパスが<span>Talend Studio</span>に渡されるので、サブスクリプションベースのユーザーは<span>データビューアー</span>をフルに活用して、MapRに保存されたデータを<span>Talend Studio</span>でローカルに表示できます。</p> </li> </ul><br><br>Hadoopディストリビューションのインストール方法の詳細は、使用しているHadoopディストリビューションに対応するマニュアルをご覧ください。 |
| 制限事項 | [Use kerberos authentication] (Kerberos認証を使用)をオンにすると、コンポーネントは、IBM JVMと連動できません。 |

**関連概念**

[Hortonworks Data PlatformでのHCatalogテーブルの管理(非推奨)](https://help.qlik.com/talend/ja-JP/components/8.0/hcatalog/thcatalogoperation-thcatalogload-tlogrow-managing-hcatalog-tables-on-hortonworks-data-platform-standard-component-bigdata-this)