tS3BucketCreateの標準プロパティ

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

標準のtS3BucketCreateコンポーネントは、Cloudファミリーに属しています。

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

基本設定

[Use existing connection] (既存の接続を使用)	定義済みの接続の詳細を再利用する場合は、このチェックボックスをオンにして、[Component List] (コンポーネントリスト)ドロップダウンリストから、目的の接続コンポーネントを選択します。
[Access Key] (アクセスキー)	AWSアカウントを一意に識別するアクセスキーID。アクセスキーとアクセスシークレットを取得する方法は、Getting Your AWS Access Keysをご覧ください。
[Secret Key] (シークレットキー)	シークレットアクセスキーは、アクセスキーと合わせてセキュリティ認証情報を構成しています。シークレットキーを入力するには、シークレットキーフィールドの横にある[...]ボタンをクリックし、ポップアップダイアログボックスにシークレットキーを二重引用符の間に入力し、OKをクリックして設定を保存します。
[Credential Provider] (認証情報プロバイダー)	`Static Credentials`、`Inherit credentials from AWS role`、`Web Identity Token`、`Profile credentials or inherit from AWS role`のいずれかのAWSセキュリティ認識情報を取得する方法を指定します。 `Static Credentials`: access keyとsecret keyをAWSセキュリティ認証情報として使用します。 `Inherit credentials from AWS role`: EMRインスタンスメタデータからAWSセキュリティ認証情報を取得します。このオプションを使用するには、Amazon EMRクラスターを開始する必要があり、このクラスターでジョブを実行する必要があります。詳細は、Using an IAM Role to Grant Permissions to Applications Running on Amazon EC2 Instancesをご覧ください。このオプションを使用すると、ジョブにAWSキーを配置せずにジョブを開発できるため、組織のセキュリティポリシーに簡単に準拠できます。 `Web Identity Token`: Amazon S3接続を確立するためにWebトークンを使用します。 `Profile credentials or inherit from AWS role`: ファイル(プロファイル設定ファイル)に保存されている認証情報をAWSセキュリティ認証情報として使うか、AWSロールからAWSセキュリティ認証情報を継承します。 AWSセキュリティ認証情報は、プロファイル設定ファイルで、プロファイルにグルーピングできます。プロファイル設定ファイルには、1つ以上のプロファイルを含めます。オプションで、[Profile config file path] (プロファイル設定ファイルパス)フィールドでプロファイル設定ファイルを、[Profire name] (プロファイル名)フィールドで使用されるプロファイルを指定できます。 [Profile config file path] (プロファイル設定ファイルパス)フィールドと[Profile name] (プロファイル名)フィールドが空のままである場合は、 <user folder>/.aws/credentialsプロファイル設定ファイルとして使われ、defaultという名前の付いたプロファイルが使われます。 EC2インスタンスの場合は、プロファイル(特定またはデフォルトのプロファイル)が存在しないと、コンポーネントがAWSロールからセキュリティ認証情報を継承することを試行します。注: [Profile config file path] (プロファイル設定ファイルパス)フィールドと[Profile name] (プロファイル名)フィールドは、`Profile credentials or inherit from AWS role`が選択されている場合に利用できます。 tRedshiftBulkExec、 tRedshiftOutputBulk、tRedshiftOutputBulkExecは、`Static Credentials`または`Inherit credentials from AWS role`である[Credential Provider] (認証情報プロバイダー)で確立されたS3接続のみをサポートします。注: [Credential Provider] (認証情報プロバイダー)ドロップダウンリストはTalendのR2021-04以降のStudioマンスリーアップデートをインストールした時のみ利用できます。詳細は管理者にお問い合わせください。 `Profile credentials or inherit from AWS role`オプション、[Profile config file path] (プロファイル設定ファイルパス)フィールド、[Profile name] (プロファイル名)フィールドは、Talendが提供するR2021-07以降のStudioマンスリーアップデートをインストールしている場合にのみ使用できます。詳細は管理者にお問い合わせください。
[Assume Role] (ロールを引き受け)	AWS IAMロールに関連付けられており、自分のユーザーアカウントに付与されていないアクセス権限を一時的に必要とする場合は、このチェックボックスをオンにすればそのロールを引き受けることができます。その後、次のパラメーターの値を指定して、新しく引き受けたロールセッションを作成します。
[Region] (リージョン)	リストからリージョン名を選択するか、リスト内で二重引用符の間にリージョンを入力して("us-east-1"など)、AWSリージョンを指定します。AWSリージョンの詳細の詳細は、Regions and Endpointsをご覧ください。
[Bucket] (バケット)	作成するバケットの名前(最上位フォルダー)。
[Die on error] (エラー発生時に強制終了)	このチェックボックスをオンにすると、エラー時に行をスキップし、エラーの発生していない行の処理が完了されます。デフォルトでは選択されていません。

詳細設定

[Config client] (クライアント設定)	このチェックボックスをオンにすると、クライアントパラメーターを設定できます。 [Client parameter] (クライアントパラメーター): リストからクライアントパラメーターを選択します。 [Value] (値): パラメーター値を入力します。 [Use existing connection] (既存の接続を使用)を選択した場合は使用できません。
[STS Endpoint] (STSエンドポイント)	このチェックボックスをオンにして、表示されたフィールドで、セッション認証情報の取得先とするAWS Security Token Service(STS)のエンドポイントを指定します。たとえば`sts.amazonaws.com`と入力します。このチェックボックスは、[Assume role] (ロールを引き受け)チェックボックスがオンになっている場合のみ利用できます。
[Signing region] (サインインリージョン)	STSサービスのAWSリージョンを選択します。リストにリージョンがない場合は、リージョン名を二重引用付きで入力します。デフォルト値は`us-east-1`です。このドロップダウンリストは、[Assume Role] (ロールを引き受け)チェックボックスがオンになっている場合のみ利用できます。
[External Id] (外部ID)	ロールの持ち主であるアカウントの管理者から外部IDを提供されている場合は、その値をここに入力します。[External Id] (外部ID)は、一定数のユーザーがロールを引き受けられるようにする一意の識別子です。このフィールドは、[ Assume Role] (ロールを引き受け)チェックボックスがオンになっている場合のみ利用できます。
[Serial number] (シリアル番号)	ロールを引き受けた場合、そのロールの信頼ポリシーで多エレメント認証(MFA)が必要になることがあります。その際は、ロールを引き受けるユーザーに関連付けられているハードウェアや仮想MFAデバイスの識別番号を指定する必要があります。このフィールドは、[ Assume Role] (ロールを引き受け)チェックボックスがオンになっている場合のみ利用できます。
[Token code] (トークンコード)	ロールを引き受けた場合、そのロールの信頼ポリシーで多エレメント認証(MFA)が必要になることがあります。その際は、トークンコードを指定する必要があります。このトークンコードは、MFAデバイスによって生成される時間ベースのワンタイムパスワードです。このフィールドは、[ Assume Role] (ロールを引き受け)チェックボックスがオンになっている場合のみ利用できます。
[Tags] (タグ)	キー-値ペアという形式でセッションタグをリスト表示します。ポリシーでこれらのセッションタグを使えば、リクエストへのアクセスを許可したり拒否したりできます。 [Transitive] (推移的): このチェックボックスをオンにすると、タグがロールチェーンの次のロールまで存続することが示されます。タグの詳細は、 AWS STSでのセッションタグの受け渡しをご覧ください。このフィールドは、[ Assume Role] (ロールを引き受け)チェックボックスがオンになっている場合のみ利用できます。
[IAM Policy ARNs] (IAMポリシーARN)	マネージドセッションポリシーとして使うIAMマネージドポリシーのAmazon Resource Names(ARN)を入力します。マネージドセッションポリシーを使ってセッションの権限を制限します。このポリシーはロールと同じアカウントに存在することが必要です。結果として得られるセッションの権限は、そのロールのIDベースのポリシーとセッションポリシーの中間となります。セッションポリシーの詳細は、ポリシーとアクセス許可で該当するセクションをご覧ください。このフィールドは、[ Assume Role] (ロールを引き受け)チェックボックスがオンになっている場合のみ利用できます。
[Policy] (ポリシー)	セッションポリシーとして使うIAMポリシーをJSON形式で入力します。セッションポリシーを使ってセッションの権限を制限します。結果として得られるセッションの権限は、そのロールのIDベースのポリシーとセッションポリシーの中間となります。セッションポリシーの詳細は、ポリシーとアクセス許可で該当するセクションをご覧ください。このフィールドは、[ Assume Role] (ロールを引き受け)チェックボックスがオンになっている場合のみ利用できます。
[Access control] (アクセス制御)	このチェックボックスは、バケットでアクセス制御リスト(ACL)を設定する時にオンにします。 [Access control] (アクセス制御)を選択した状態でAccessテーブルの下にある [+]ボタンをクリックし、新しい行を追加します。ここでは、次の方法でAWSユーザーアカウントを追加して権限を設定できます。 Account canonical ID / emailカラムに、ユーザーの正規ユーザーIDかメールアドレスを二重引用符で囲んで入力します。作成されたバケット内のオブジェクトをリスト表示する権限を付与する場合は、[List objects] (オブジェクトをリスト表示)カラムのチェックボックスをオンにします。作成されたバケット内のオブジェクトを作成、上書き、削除する権限を付与する場合は、[Write objects] (オブジェクトを書き込む)カラムのチェックボックスをオンにします。作成されたバケットのACL (アクセス制御リスト)を読み取る権限を付与する場合は、[Read bucket permissions] (バケットの読み取り権限)カラムのチェックボックスをオンにします。作成されたバケットのACL (アクセス制御リスト)を書き込む権限を付与する場合は、[Write bucket permissions] (バケットの書き込み権限)カラムのチェックボックスをオンにします。注: Account canonical ID / emailカラム内の文字列に@が含まれている場合は、メールアドレスと見なされます。 [Access control] (アクセス制御)が選択されていない場合、バケットを作成するユーザーがそのバケットの所有者となり、そのバケットに関する権限をすべて持つことになります。 [Access control] (アクセス制御)が選択されている場合、バケットを作成するユーザーがそのバケットの所有者となりますが、そのバケットに関する権限は持ちません。所有者への権限の付与は、[Access] (アクセス)テーブルで上述の方法で行います。 AWSグループはサポートされていません。
[Canned Access Control] (Cannedアクセス制御)	ドロップダウンリストからオプションを選択し、事前定義された権限を現在のリソースに与えます。Cannedアクセス制御については、Canned ACLをご覧ください。注: このオプションは、TalendのR2021-03以降のStudioマンスリーアップデートをインストールした時のみ利用できます。詳細は管理者にお問い合わせください。
[tStatCatcher Statistics] (tStatCatcher統計)	このチェックボックスをオンにすると、コンポーネントレベルでログデータを収集できます。

グローバル変数

ERROR_MESSAGE	エラー発生時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。この変数は、[Die on error] (エラー発生時に強制終了)チェックボックスがオンになっている場合のみ機能します。

使用方法

使用ルール	このコンポーネントは、単独で、またはtS3BucketExistなどの他のS3コンポーネントと共に使います。
[Dynamic settings] (ダイナミック設定)	[+]ボタンをクリックしてテーブルに行を追加し、[Code] (コード)フィールドにコンテキスト変数を入力して、ジョブ内で計画した複数の接続からデータベース接続をダイナミックに選択します。この機能は、データストラクチャーが同じでデータベースが異なるデータベーステーブルにアクセスする必要がある場合、特に、Talend Studioを介さずにジョブをデプロイおよび実行する必要がある時など、ジョブの設定を変更できない環境で作業している場合に役立ちます。ダイナミックパラメーターを定義すると、[Basic settings] (基本設定)ビューの[Component List] (コンポーネントリスト)ボックスは利用できなくなります。ダイナミックパラメーターの定義法を示すユースケースについては、コンテキストベースのダイナミック接続によってデータベースからデータを読み取りと、ダイナミックにロードされた接続パラメーターを使って異なるMySQLデータベースからデータを読み取りをご覧ください。[Dynamic settings] (ダイナミック設定)とコンテキスト変数については、Talend Studioユーザーガイドをご覧ください。

使用ルール

このコンポーネントは、単独で、またはtS3BucketExistなどの他のS3コンポーネントと共に使います。

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

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

ダイナミックパラメーターを定義すると、[Basic settings] (基本設定)ビューの[Component List] (コンポーネントリスト)ボックスは利用できなくなります。

ダイナミックパラメーターの定義法を示すユースケースについては、コンテキストベースのダイナミック接続によってデータベースからデータを読み取りと、ダイナミックにロードされた接続パラメーターを使って異なるMySQLデータベースからデータを読み取りをご覧ください。[Dynamic settings] (ダイナミック設定)とコンテキスト変数については、Talend Studioユーザーガイドをご覧ください。