tAzureStorageListの標準プロパティ

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

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

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

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

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

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

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

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

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

[Authentication type] (認証タイプ)

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

• [Basic] (基本): このオプションを選択すると、ストレージアカウントのアクセスキーまたは共有アクセス署名を使ってMicrosoft Azure Blobストレージにアクセスできます。関連情報は、Configuring Azure Storage connection stringsおよびUsing shared access signatures (SAS)をご覧ください。
• Azure Active Directory: このオプションを選択すると、Azure Active Directory (Azure AD)の認証情報を使ってMicrosoft Azure Blobストレージにアクセスできます。関連情報は、Authorize access to blobs and queues using Azure Active Directoryをご覧ください。
• [Managed identities] (マネージドID): このオプションを選択すると、Azure Active Directoryで保護されているリソースへのアクセスで、システムに割り当てられたマネージドIDを使用できます。詳細は、What are managed identities for Azure resourcesとAzure services that can use managed identities to access other servicesをご覧ください。

• Azure Global
• Azure China
• Azure Germany
• Azure Government
• Azure Custom

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

[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>は許可されているサービスの名前(Blob、file、queue、tableのいずれか)、<$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を選択します。提供されるパラメーターは次のとおりです。

スキーマとは行の説明のことです。処理して次のコンポーネントに渡すフィールド(カラム)数を定義します。Sparkジョブを作成する場合、フィールドの命名時は予約語のlineを避けます。

• [Built-in] (組み込み): そのコンポーネントに対してのみスキーマを作成し、ローカルに保管します。

• [Repository] (リポジトリー): スキーマは作成済みで、リポジトリーに保管されています。さまざまなプロジェクトやジョブデザインで再利用できます。

このコンポーネントのスキーマは、文字列型の単一のカラムBlobNameで事前定義されています。これは、リスト表示する各blobの名前を示します。

スキーマを変更するには[Edit schema] (スキーマを編集)をクリックします。現在のスキーマがリポジトリータイプの場合は、3つのオプションを利用できます。

• [View schema] (スキーマを表示): スキーマのみを表示する場合は、このオプションを選択します。

• [Change to built-in property] (組み込みのプロパティに変更): ローカルで変更を行うためにスキーマを組み込みに変更する場合は、このオプションを選択します。

• [Update repository connection] (リポジトリー接続をアップデート): リポジトリーに保存されているスキーマに変更を加え、変更後にそのコンテンツをすべてのジョブにプロパゲートするかどうかを決める場合は、このオプションを選択します。

  変更を現在のジョブにのみ反映する場合は、変更後、[No] (いいえ)を選択し、[Repository Content] (リポジトリーコンテンツ)ウィンドウで再びこのスキーマのメタデータを選択します。

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

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

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

[tStatCatcher Statistics] (tStatCatcher統計)

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

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

このコンポーネントによって処理されるBlob名。これはAfter変数で、文字列を返します。

処理された行数。これはAfter変数で、整数を返します。

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

使用ルール

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

前提条件

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