# Apache Spark BatchのtGSConfigurationプロパティ

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

Spark BatchのtGSConfigurationコンポーネントは、ストレージファミリーに属しています。

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

## 基本設定

このコンポーネントをGoogle Dataprocと併用する場合:

| [Properties] (プロパティ) | 説明 |
| --- | --- |
| [Google Storage bucket] (Googleストレージバケット) | ジョブ全体で使用するバケットの名前を入力します。次に、tFileInputDelimitedまたはtFileOutputDelimitedなど、Fileのコンポーネントでは、このバケットのディレクトリーが使用されます。<br><br>たとえば、このフィールドにmy\_bucketと入力し、tFileInputDelimitedの[Folder] (フォルダー)フィールドに/user/ychenを入力すると、tFileInputDelimitedによってgs://my\_bucket/user/ychenからデータが読み取られます。 |

このコンポーネントをその他のディストリビューションと併用する場合:

| [Properties] (プロパティ) | 説明 |
| --- | --- |
| [Project ID] (プロジェクトID) | Google Cloud PlatformプロジェクトのIDを入力します。<br><br>プロジェクトIDがわからない場合は、Google Cloud Platformサービスの[Manage Resources]ページでご確認ください。 |
| [Google Storage bucket] (Googleストレージバケット) | ジョブ全体で使用するバケットの名前を入力します。次に、tFileInputDelimitedまたはtFileOutputDelimitedなど、Fileのコンポーネントでは、このバケットのディレクトリーが使用されます。<br><br>たとえば、このフィールドにmy\_bucketと入力し、tFileInputDelimitedの[Folder] (フォルダー)フィールドに/user/ychenを入力すると、tFileInputDelimitedによってgs://my\_bucket/user/ychenからデータが読み取られます。 |
| [Use P12 credentials file format] (P12認証情報ファイル形式を使用) | 使用するGoogleクレデンシャルファイルがP12形式の場合は、このチェックボックスをオンにし、表示される[Service account Id] (サービスアカウントID)フィールドにP12認証情報ファイルが作成されたサービスアカウントのIDを入力します。 |
| [Path to Google Credentials file] (Googleクレデンシャルファイルへのパス) | 使用するユーザーアカウントに関連付けられている認証情報ファイルのパスを入力します。このファイルはTalendジョブが実際に起動および実行されるコンピューターに保管されている必要があります。<br><br>Talend JobServerを使用してジョブを実行する場合、ジョブを起動するTalend JobServerのマシンだけでなく、ジョブを実行するSparkクラスターのワーカーマシンにも認証情報ファイルを保管します。Talend JobServerを使用しない場合は、ジョブを起動するローカルマシンとSparkクラスターのワーカーマシンに認証情報ファイルを保管します。 |

## [Global Variables] (グローバル変数)

| 変数 | 説明 |
| --- | --- |
| グローバル変数 | 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)をご覧ください。 |

## 使用方法

| 使用方法のガイダンス | 説明 |
| --- | --- |
| **使用ルール** | Google Storageへの接続設定を行う場合は、1つのジョブで複数のtGSConfigurationコンポーネントを使用できます。<br><br>たとえば1つのジョブで2つのtGSConfigurationコンポーネントを使い、認証情報が異なる別々のGoogle Storageバケットを使うことも可能です。2つのtGSConfigurationコンポーネントを使うためには、[Google Storage console] (Google Storageコンソール) &gt; [Bucket] (バケット) &gt; [Permissions] (権限) &gt; [Roles] (ロール)で正しい権限を設定する必要があります。<br><br>たとえば次の操作を行っているとします。<br><br><ul> <li> <span>userX@project-1234.iam.gserviceaccount.com</span>と<span>userX_bucket</span>を使って<span>project-1234</span>で作業                         </li> <li> <span>userY@project-4567.iam.gserviceaccount.com</span>と<span>userY_bucket</span>を使って<span>project-4567</span>で作業                         </li> </ul><br><br><br>以下の操作が必要となります。<br><br><ul> <li><span>userY_bucket</span>に<span>userX@project-1234.iam.gserviceaccount.com</span>を<span>[Storage Admin] (ストレージ管理者)</span>として追加し、<span>project-4567</span>をポイントします。                         </li> <li><span>userX_bucket</span>に<span>userY@project-4567.iam.gserviceaccount.com</span>を<span>[Storage Admin] (ストレージ管理者)</span>として追加し、<span>project-4567</span>をポイントします。                         </li> </ul><br><br><br>IAM権限の詳細は、[Google Storage documentation](https://cloud.google.com/storage/docs/access-control/using-iam-permissions#console)をご覧ください。<br><br>Talend Studio 8.0のR2022-12以降、tGSConfigurationが[Local] (ローカル)モードでSpark Universalを、Google Cloud PlatformでDatabricksをサポートするようになりました。 |
| [Spark Connection] (Spark接続) | [Run] (実行)ビューの[Spark configuration] (Spark設定)タブで、ジョブ全体でのSparkクラスターへの接続を定義します。また、ジョブでは、依存jarファイルを実行することを想定しているため、Sparkがこれらのjarファイルにアクセスできるように、これらのファイルの転送先にするファイルシステム内のディレクトリーを指定する必要があります。<br><br><ul> <li> <div> <span>Yarnモード</span>(YarnクライアントまたはYarnクラスター):<ul> <li> <p>Google Dataprocを使用している場合、<span>[Spark configuration] (Spark設定)</span>タブの<span>[Google Storage staging bucket] (Google Storageステージングバケット)</span>フィールドにバケットを指定します。</p> </li> <li> <p>HDInsightを使用している場合、<span>[Spark configuration] (Spark設定)</span>タブの<span>[Windows Azure Storage configuration] (Windows Azure Storage設定)</span>エリアでジョブのデプロイメントに使用するブロブを指定します。</p> </li> <li>Altusを使用する場合は、<span>[Spark configuration] (Spark設定)</span>タブでジョブのデプロイにS3バケットまたはAzure Data Lake Storageを指定します。</li> <li> <p>オンプレミスのディストリビューションを使用する場合は、クラスターで使われているファイルシステムに対応する設定コンポーネントを使用します。一般的に、このシステムはHDFSになるため、<a href="https://help.qlik.com/talend/r/ja-JP/8.0/components/hdfs/thdfsconfiguration">tHDFSConfiguration</a>を使用します。</p> </li> </ul> </div> </li> <li> <p> <span>[Standalone mode] (スタンドアロンモード)</span>: クラスターで使われているファイルシステム(<a href="https://help.qlik.com/talend/r/ja-JP/8.0/components/hdfs/thdfsconfiguration-properties-for-apache-spark-batch">tHDFSConfiguration Apache Spark Batch</a>や<a href="https://help.qlik.com/talend/r/ja-JP/8.0/components/amazon-s3/ts3configuration-properties-for-apache-spark-batch">tS3Configuration Apache Spark Batch</a>など)に対応する設定コンポーネントを使用します。</p> <p>ジョブ内に設定コンポーネントがない状態でDatabricksを使用している場合、ビジネスデータはDBFS (Databricks Filesystem)に直接書き込まれます。</p> </li> </ul><br><br>この接続は、ジョブごとに有効になります。 |