メイン コンテンツをスキップする 補完的コンテンツへスキップ

tAzureStorageGetの標準プロパティ

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

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

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

基本設定

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

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

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

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

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

[Connection Component] (接続コンポーネント)ドロップダウンリストから、他の接続コンポーネントを選択した場合、このプロパティは、利用できません。

[Connection Component] (接続コンポーネント)

ドロップダウンリストから、Azure Storageへの接続を設定するために接続の詳細を使用するコンポーネントを選択します。

[Account Name] (アカウント名)

アクセスする必要のあるストレージアカウントの名前を入力します。ストレージアカウント名は、使用するMicrosoft Azure Storageシステムのストレージアカウントダッシュボード内にあります。このストレージアカウントへの適切なアクセス権をシステム管理者から得ていることを確認します。

[Authentication type] (認証タイプ)

Microsoft Azure Blobストレージに接続するための認証タイプとして、[Basic] (基本)Azure Active Directory[Managed identities] (マネージドID)のいずれかに設定します。

情報メモ注: [Managed identities] (マネージドID)オプションは、Talendが提供する8.0.1 R2023-03以降のTalend Studioマンスリーアップデートをインストール済みである場合のみ利用できます。詳細は管理者にお問い合わせください。
リージョン ドロップダウンリストから、次のAzureリージョンから1つ選択します。
  • Azure Global
  • Azure China
  • Azure Germany
  • Azure Government
  • Azure Custom
Azure Customオプションを選択し、[Endpoint suffix] (エンドポイントサフィックス)フィールドにエンドポイントサフィックスを、[Authority host] (機関ホスト)フィールドにとオーソリティホストURLをそれぞれ入力することで、カスタマイズされたAzureリージョンを使用できるようになります。なお、[Authentication type] (認証タイプ)ドロップダウンリストから、Azure Active Directoryを選択した場合は、オーソリティホストURLが必要です。

このドロップダウンリストは、[Authentication type] (認証タイプ)ドロップダウンリストから、[Managed identities] (マネージドID)を選択した場合は利用できません。

情報メモ注: [Region] (リージョン)ドロップダウンリストは、Talendが提供する8.0.1 R2023-03以降のTalend Studioマンスリーアップデートをインストール済みである場合のみ利用できます。詳細は管理者にお問い合わせください。

[Account key] (アカウントキー)

アクセスする必要のあるストレージアカウントに関連付けられたキーを入力します。どのアカウントでも利用できるキーが2つあり、このアクセスにはデフォルトでどちらのキーも使用できます。ドロップダウンリストから、Azure Storageへの接続を設定するために接続の詳細を使用するコンポーネントを選択します。

このオプションは、[Authentication type] (認証タイプ)ドロップダウンリストから、[Basic] (基本)を選択した場合に利用できます。

[Account key] (アカウントキー)

アクセスする必要のあるストレージアカウントに関連付けられたキーを入力します。どのアカウントでも利用できるキーが2つあり、このアクセスにはデフォルトでどちらのキーも使用できます。ドロップダウンリストから、Azure Storageへの接続を設定するために接続の詳細を使用するコンポーネントを選択します。

このオプションは、[Authentication type] (認証タイプ)ドロップダウンリストから、[Basic] (基本)を選択した場合に利用できます。

[Protocol] (プロトコル)

作成する接続のプロトコルを選択します。

このオプションは、[Authentication type] (認証タイプ)ドロップダウンリストから、[Basic] (基本)を選択した場合に利用できます。

Use Azure Shared Access Signature

アカウントキーを使用せずにストレージリソースにアクセスする場合は、このチェックボックスを選択してShared Access Signature (SAS)を使用します。詳細は、Using Shared Access Signatures (SAS)をご覧ください。

表示される[Azure Shared Access Signature]フィールドに、アカウントのSAS URLを二重引用符で囲んで入力します。SASの生成後に、Microsoft Azureポータルで許可されている各サービスのSAS URLが取得できます。SAS URLの形式はhttps://<$storagename><$service>.core.windows.net/<$sastoken>となります。<$storagename>はストレージアカウント名、<$service>は許可されているサービスの名前(Blobfilequeuetableのいずれか)、<$sastoken>はSASトークンの値です。詳細は、Constructing the Account SAS URIをご覧ください。

SASの期間が有効であることをご確認ください。SASが有効となる開始時刻と無効となる有効期限を生成時に設定できます。また、ジョブの実行時にSASがまだ有効であることを確認する必要があります。

このオプションは、[Authentication type] (認証タイプ)ドロップダウンリストから、[Basic] (基本)を選択した場合に利用できます。

[Tenant ID] (テナントID)

Azure ADテナントのIDを入力します。関連情報は、Acquire a token from Azure AD for authorizing requests from a client applicationをご覧ください。

このオプションは、[Authentication method] (認証方式)ドロップダウンリストから、Azure Active Directoryを選択した場合に利用できます。

[Client ID] (クライアントID)

アプリケーションのクライアントIDを入力します。関連情報は、Acquire a token from Azure AD for authorizing requests from a client applicationをご覧ください。

このオプションは、[Authentication method] (認証方式)ドロップダウンリストから、Azure Active Directoryを選択した場合に利用できます。

[Client Secret] (クライアントシークレット)

アプリケーションのクライアントシークレットを入力します。関連情報は、Acquire a token from Azure AD for authorizing requests from a client applicationをご覧ください。

このオプションは、[Authentication method] (認証方式)ドロップダウンリストから、Azure Active Directoryを選択した場合に利用できます。

[Container name] (コンテナー名)

取得するblobコンテナーの名前を入力します。

ローカルフォルダー

パスを入力するか、取得したBlobを格納する必要があるフォルダーを参照します。

Blob

このテーブルに記入して取得するBlobを選択します。提供されるパラメーターは次のとおりです。

  • [Prefix] (プレフィックス): 取得する必要があるBlobの名前の共通プレフィックスを入力します。このプレフィックスを使用すると、指定されたコンテナーで名前に指定したプレフィックスを持つBlobをフィルタリングできます。

    Blob名には、Blob自体の仮想階層が含まれています。この階層はそのBlobへの仮想パスであり、そのBlobが保存されているコンテナーに関連しています。たとえば、photosという名前のコンテナーでは、写真Blobの名前は2014/US/Oakland/Talend.jpgのようになります。

    このため、プレフィックスを定義すると、実際にはBlobフィルターとしてディレクトリーレベルを指定していることになります。たとえば、2014/または2014/US/などです。

    コンテナーレベルの直下に保存されているBlob(名前の中に仮想パスがないBlob)を選択する場合は、引用符を削除してnullと入力します。

  • [Include sub-directories] (サブディレクトリーを含める): このチェックボックスをオンにすると、Blobプレフィックス列で指定されたディレクトリーレベルの下にあるこれらのフォルダー内のすべてのサブフォルダーとBlobが取得されます。このチェックボックスをオフのままにしておくと、tAzureStorageGetはそのディレクトリーレベルの直下のBlobだけを返します。

  • [Create parent directories] (親ディレクトリーの作成): このチェックボックスをオンにすると、ローカルフォルダーで取得したBlobの仮想ディレクトリーが複製されます。

    このチェックボックスをオフのままにした場合は、取得したBlobがコンテナー内にあるのと同じディレクトリーがローカルフォルダーに存在する必要があります。

[Die on error] (エラー発生時に強制終了)

このチェックボックスを選択すると、エラー発生時にジョブの実行が停止されます。

エラーの発生した行をスキップし、エラーが発生していない行の処理を完了するには、このチェックボックスをオフにします。エラーをスキップしたら、[Row] (行)> [Reject] (リジェクト)リンクを使用してエラーの発生した行を収集できます。

詳細設定

[tStatCatcher Statistics] (tStatCatcher統計)

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

グローバル変数

CONTAINER

Blobコンテナーの名前。これはAfter変数で、文字列を返します。

LOCAL_FOLDER

このコンポーネントで使用されるローカルディレクトリー。これはAfter変数で、文字列を返します。

ERROR_MESSAGE

エラー発生時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。

使用方法

使用ルール

このコンポーネントは、ジョブやサブジョブのスタンドアロンコンポーネントとして使用できます。

前提条件

Microsoft Azure Storageに関する知識が必要です。

このページは役に立ちましたか?

このページまたはコンテンツにタイポ、ステップの省略、技術的エラーなどの問題が見つかった場合はお知らせください。