# tAzureStorageQueueInput

Azureキューの前から1つまたは複数のメッセージを取得します。

## tAzureStorageQueueInputの標準プロパティ

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

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

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

## 基本設定

| プロパティ | 説明 |
| --- | --- |
| [Property Type] (プロパティタイプ) | 接続の詳細を設定する方法を選択します。<br><br><ul> <li> <p> <span>[Built-In] (組み込み)</span>: このコンポーネントの接続の詳細がローカルに設定されます。関連するすべての接続のプロパティ値を手動で指定する必要があります。</p> </li> <li> <p> <span>[Repository] (リポジトリー)</span>: <span><span>[Repository] (リポジトリー)</span> &gt; <span>[Metadata] (メタデータ)</span></span>で一元的に保存された接続の詳細が、このコンポーネントによって再使用されます。 </p> <p>このチェックボックスの横にある <span>[...]</span> ボタンをクリックし、表示された <span>[Repository Content] (リポジトリーのコンテンツ)</span>ダイアログボックスで、再使用する接続の詳細を選択すると、関連するすべての接続のプロパティに値が自動的に入力されます。</p> </li> </ul><br><br>[Connection Component] (接続コンポーネント)ドロップダウンリストから、他の接続コンポーネントを選択した場合、このプロパティは、利用できません。 |
| [Connection Component] (接続コンポーネント) | ドロップダウンリストから、Azure Storageへの接続を設定するために接続の詳細を使用するコンポーネントを選択します。 |
| Account Name (アカウント名) | アクセスする必要のあるストレージアカウントの名前を入力します。ストレージアカウント名は、使用するMicrosoft Azure Storageシステムのストレージアカウントダッシュボード内にあります。このストレージアカウントへの適切なアクセス権をシステム管理者から得ていることを確認します。 |
| [Authentication type] (認証タイプ) | Microsoft Azure Blobストレージに接続するための認証タイプとして、[Basic] (基本)、Azure Active Directory、[Managed identities] (マネージドID)のいずれかに設定します。<br><br><ul> <li> <span>[Basic] (基本)</span>: このオプションを選択すると、ストレージアカウントのアクセスキーまたは共有アクセス署名を使ってMicrosoft Azure Blobストレージにアクセスできます。関連情報は、<a href="https://docs.microsoft.com/ja-jp/azure/storage/common/storage-configure-connection-string" target="_blank">Configuring Azure Storage connection strings</a>および<a href="https://docs.microsoft.com/en-us/azure/storage/common/storage-sas-overview" target="_blank">Using shared access signatures (SAS)</a>をご覧ください。</li> <li> <span>Azure Active Directory</span>: このオプションを選択すると、Azure Active Directory (Azure AD)の認証情報を使ってMicrosoft Azure Blobストレージにアクセスできます。関連情報は、<a href="https://docs.microsoft.com/ja-jp/azure/storage/common/storage-auth-aad?toc=/azure/storage/blobs/toc.json" target="_blank">Authorize access to blobs and queues using Azure Active Directory</a>をご覧ください。</li> <li><span>[Managed identities] (マネージドID)</span>: このオプションを選択すると、Azure Active Directoryで保護されているリソースへのアクセスで、システムに割り当てられたマネージドIDを使用できます。詳細は、<a href="https://learn.microsoft.com/en-us/azure/active-directory/managed-identities-azure-resources/overview" target="_blank">What are managed identities for Azure resources</a>と<a href="https://learn.microsoft.com/en-us/azure/active-directory/managed-identities-azure-resources/managed-identities-status" target="_blank">Azure services that can use managed identities to access other services</a>をご覧ください。</li> </ul><br><br>情報メモ注: [Managed identities] (マネージドID)オプションは、Talendが提供する8.0.1 R2023-03以降のTalend Studioマンスリーアップデートをインストール済みである時のみ利用可能です。詳細は管理者にお問い合わせください。 |
| [Region] (リージョン) | ドロップダウンリストから、次のAzureリージョンから1つ選択します。<br><br><ul> <li><span>Azure Global</span></li> <li><span>Azure China</span></li> <li><span>Azure Germany</span></li> <li><span>Azure Government</span></li> <li><span>Azure Custom</span></li> </ul><br><br>Azure Customオプションを選択し、[Endpoint suffix] (エンドポイントサフィックス)フィールドにエンドポイントサフィックスを、[Authority host] (機関ホスト)フィールドにとオーソリティホストURLをそれぞれ入力することで、カスタマイズされたAzureリージョンを使用できるようになります。なお、[Authentication type] (認証タイプ)ドロップダウンリストから、Azure Active Directoryを選択した場合は、オーソリティホストURLが必要です。<br><br>このドロップダウンリストは、[Authentication type] (認証タイプ)ドロップダウンリストから、[Managed identities] (マネージドID)を選択した場合は利用できません。<br><br>情報メモ注: [Region] (リージョン)ドロップダウンリストは、Talendが提供する8.0.1 R2023-03以降のTalend Studioマンスリーアップデートをインストール済みである時のみ利用可能です。詳細は管理者にお問い合わせください。 |
| [Account key] (アカウントキー) | アクセスする必要のあるストレージアカウントに関連付けられたキーを入力します。どのアカウントでも利用できるキーが2つあり、このアクセスにはデフォルトでどちらのキーも使用できます。ドロップダウンリストから、Azure Storageへの接続を設定するために接続の詳細を使用するコンポーネントを選択します。<br><br>このオプションは、[Authentication type] (認証タイプ)ドロップダウンリストから、[Basic] (基本)を選択した場合に利用できます。 |
| [Protocol] (プロトコル) | 作成する接続のプロトコルを選択します。<br><br>このオプションは、[Authentication type] (認証タイプ)ドロップダウンリストから、[Basic] (基本)を選択した場合に利用できます。 |
| Use Azure Shared Access Signature | このチェックボックスを選択すると、Shared Access Signature (SAS)を使い、アカウントキーを必要とせずにストレージリソースにアクセスできます。詳細は、[Using Shared Access Signatures (SAS)](https://docs.microsoft.com/ja-jp/azure/storage/storage-dotnet-shared-access-signature-part-1)をご覧ください。<br><br>表示される[Azure Shared Access Signature]フィールドに、アカウントのSAS URLを二重引用符で囲んで入力します。SASの生成後に、Microsoft Azureポータルで許可されている各サービスのSAS URLが取得できます。SAS URLの形式はhttps://&lt;$storagename&gt;&lt;$service&gt;.core.windows.net/&lt;$sastoken&gt;となります。&lt;$storagename&gt;はストレージアカウント名、&lt;$service&gt;は許可されているサービスの名前(Blob、file、queue、tableのいずれか)、&lt;$sastoken&gt;はSASトークンの値です。詳細は、[Constructing the Account SAS URI](https://docs.microsoft.com/fr-fr/rest/api/storageservices/Constructing-an-Account-SAS?redirectedfrom=MSDN#constructing-the-account-sas-uri)をご覧ください。<br><br>SASの期間が有効であることをご確認ください。SASが有効となる開始時刻と無効となる有効期限を生成時に設定できます。また、ジョブの実行時にSASがまだ有効であることを確認する必要があります。<br><br>このオプションは、[Authentication type] (認証タイプ)ドロップダウンリストから、[Basic] (基本)を選択した場合に利用できます。 |
| [Tenant ID] (テナントID) | Azure ADテナントのIDを入力します。関連情報は、[Acquire a token from Azure AD for authorizing requests from a client application](https://docs.microsoft.com/ja-jp/azure/storage/common/storage-auth-aad-app)をご覧ください。<br><br>このオプションは、[Authentication method] (認証方式)ドロップダウンリストから、Azure Active Directoryを選択した場合に利用できます。 |
| [Client ID] (クライアントID) | アプリケーションのクライアントIDを入力します。関連情報は、[Acquire a token from Azure AD for authorizing requests from a client application](https://docs.microsoft.com/ja-jp/azure/storage/common/storage-auth-aad-app)をご覧ください。<br><br>このオプションは、[Authentication method] (認証方式)ドロップダウンリストから、Azure Active Directoryを選択した場合に利用できます。 |
| [Client Secret] (クライアントシークレット) | アプリケーションのクライアントシークレットを入力します。関連情報は、[Acquire a token from Azure AD for authorizing requests from a client application](https://docs.microsoft.com/ja-jp/azure/storage/common/storage-auth-aad-app)をご覧ください。<br><br>このオプションは、[Authentication method] (認証方式)ドロップダウンリストから、Azure Active Directoryを選択した場合に利用できます。 |
| キュー名 | メッセージの取得元となるAzureキューの名前を指定します。 |
| [Schema] (スキーマ)と[Edit schema] (スキーマを編集) | スキーマとは行の説明のことです。処理して次のコンポーネントに渡すフィールド(カラム)数を定義します。Sparkジョブを作成する場合、フィールドの命名時は予約語のlineを避けます。<br><br><ul> <li> <p> <span>[Built-in] (組み込み)</span>: そのコンポーネントに対してのみスキーマを作成し、ローカルに保管します。</p> </li> <li> <p> <span>[Repository] (リポジトリー)</span>: スキーマは作成済みで、リポジトリーに保管されています。さまざまなプロジェクトやジョブデザインで再利用できます。</p> </li> </ul><br><br>このコンポーネントのスキーマは、以下のカラムで事前定義されています。<br><br><ul> <li> <span>[MessageId]</span>: メッセージのID。</li> <li> <span>[MessageContent]</span>: メッセージのボディ。</li> <li> <span>[InsertionTime]</span>: メッセージがキューに追加された時刻。</li> <li> <span>[ExpirationTime]</span>: メッセージの有効期限。</li> <li> <span>[NextVisibleTime]</span>: メッセージが次回表示される時刻。</li> <li> <span>[DequeueCount]</span>: メッセージがデキューされた回数。この値はメッセージがデキューされる度に増加しますが、メッセージが見られた時は増加しません。</li> <li> <span>[PopReceipt]</span>: メッセージを削除するために必要なポップレシート値。</li> </ul><br><br>スキーマを変更するには[Edit schema] (スキーマを編集)をクリックします。現在のスキーマがリポジトリータイプの場合は、3つのオプションを利用できます。<br><br><ul> <li> <p> <span>[View schema] (スキーマを表示)</span>: スキーマのみを表示する場合は、このオプションを選択します。</p> </li> <li> <p> <span>[Change to built-in property] (組み込みのプロパティに変更)</span>: ローカルで変更を行うためにスキーマを<span>組み込み</span>に変更する場合は、このオプションを選択します。</p> </li> <li> <p> <span>[Update repository connection] (リポジトリー接続をアップデート)</span>: リポジトリーに保存されているスキーマに変更を加え、変更後にそのコンテンツをすべてのジョブにプロパゲートするかどうかを決める場合は、このオプションを選択します。</p> <p>変更を現在のジョブにのみ反映する場合は、変更後、<span>[No] (いいえ)</span>を選択し、<span>[Repository Content] (リポジトリーコンテンツ)</span>ウィンドウで再びこのスキーマのメタデータを選択します。</p> </li> </ul> |
| メッセージ数 | 指定したキューから一度に取得するメッセージの数を入力します。上限は32です。 |
| メッセージを見る | メッセージを取得し、キューから削除せず、表示を変更しない場合は、このチェックボックスをオンにします。他の顧客は引き続きメッセージを利用できます。 |
| ストリーミング中にメッセージを削除 | このチェックボックスをオンにすると、キューからメッセージを取得する時にメッセージが削除されます。 |
| [Die on error] (エラー発生時に強制終了) | このチェックボックスを選択すると、エラー発生時にジョブの実行が停止されます。 |

## 詳細設定

| プロパティ | 説明 |
| --- | --- |
| 表示タイムアウト(秒) | サーバー時間に関連する表示のタイムアウト値(秒単位)を入力します。このタイムアウト値はメッセージが取得される時刻に追加され、NextVisibleTime値を決定します。メッセージは、取得後この時間が経過するまでの間、他のコンシューマーには表示されません。 |
| [tStatCatcher Statistics] (tStatCatcher統計) | このチェックボックスを選択すると、ジョブレベルおよび各コンポーネントレベルでジョブ処理メタデータが収集されます。 |

## グローバル変数

| 変数 | 説明 |
| --- | --- |
| NB\_LINE | 処理された行数。これはAfter変数で、整数を返します。 |
| QUEUE\_NAME | Azureキューの名前。これはAfter変数で、文字列を返します。 |
| ERROR\_MESSAGE | エラー発生時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。 |

## 使用方法

| 使用方法のガイダンス | 説明 |
| --- | --- |
| 使用ルール | このコンポーネントは、通常、ジョブまたはサブジョブの開始コンポーネントとして使い、常に出力リンクが必要です。 |