テーブルの照会

[アーティクル]
06/27/2023

Query Tables 操作は、指定されたアカウントの下位にあるテーブルの一覧を返します。

要求

要求は Query Tables 次のように構築できます。 HTTPS をお勧めします。 myaccount をストレージアカウントの名前に置き換えます。

Method	要求 URI	HTTP バージョン
`GET`	`https://myaccount.table.core.windows.net/Tables`	HTTP/1.1

エミュレートされたストレージサービス URI

エミュレートされたストレージサービスに対して要求を行うときは、エミュレーターのホスト名とテーブルサービスのポートをとして 127.0.0.1:10002指定します。その情報に従って、エミュレートされたストレージアカウントの名前を指定します。

Method	要求 URI	HTTP バージョン
`GET`	`http://127.0.0.1:10002/devstoreaccount1/Tables`	HTTP/1.1

ストレージエミュレーターの Table サービスは、Azure Table Storage といくつかの点で異なります。詳細については、「ストレージエミュレーターと Azure Storage サービスの違い」を参照してください。

URI パラメーター

この操作では Query Tables 、 OData プロトコル仕様で定義されているクエリオプションがサポートされます。

要求ヘッダー

次の表では、必須および省略可能な要求ヘッダーについて説明します。

要求ヘッダー	説明
`Authorization`	必須。承認スキーム、アカウント名、署名を指定します。詳細については、「Azure Storage への要求を承認する」をご覧ください。
`Date` または `x-ms-date`	必須。要求に対して協定世界時 (UTC) を指定します。詳細については、「Azure Storage への要求を承認する」をご覧ください。
`x-ms-version`	省略可能。この要求に使用する操作のバージョンを指定します。詳細については、「Azure Storage サービスのバージョン管理」を参照してください。
`Accept`	省略可能。応答ペイロードの受け入れられたコンテンツの種類を指定します。次のいずれかの値になります。 - `application/atom+xml` (2015-12-11 より前のバージョンのみ) - `application/json;odata=nometadata` - `application/json;odata=minimalmetadata` - `application/json;odata=fullmetadata` 詳細については、「 Table Storage 操作のペイロード形式」を参照してください。
`x-ms-client-request-id`	省略可能。ログ記録の構成時にログに記録される 1 kibibyte (KiB) 文字制限を使用して、クライアントによって生成された不透明な値を提供します。このヘッダーを使用して、クライアント側のアクティビティとサーバーが受信する要求を関連付けるよう強くお勧めします。

要求本文

なし。

[応答]

応答には、HTTP 状態コード、一連の応答ヘッダー、および応答本文が含まれています。

状態コード

操作に成功すると、状態コード 200 (OK) が返されます。

状態コードの詳細については、「状態とエラーコード」および「Table Storage のエラーコード」を参照してください。

応答ヘッダー

この操作の応答には、次のヘッダーが含まれています。応答には、追加の標準 HTTP ヘッダーも含まれる場合があります。すべての標準ヘッダーは、HTTP/1.1 プロトコル仕様に準拠しています。

応答ヘッダー	説明
`x-ms-continuation-NextTableName`	継続トークン値を返します。返されるテーブルの数が 1,000 を超える場合、またはクエリがタイムアウト期間内に終了しない場合、応答ヘッダーには継続ヘッダーが `x-ms-continuation-NextTableName` 含まれます。継続トークンの使用の詳細については、「クエリのタイムアウトと改ページ」を参照してください。
`x-ms-request-id`	行われた要求を一意に識別します。これを使用して、要求のトラブルシューティングを行うことができます。詳細については、「 API 操作のトラブルシューティング」を参照してください。
`x-ms-version`	要求の実行に使用される Table Storage のバージョンを示します。このヘッダーはバージョン 2009-09-19 以降で行った要求に対して返されます。
`Date`	サービスが応答を送信した時刻を示す UTC 日付/時刻値。
`Content-Type`	ペイロードのコンテンツの種類を示します。値は要求 `Accept` のヘッダーによって異なります。次のいずれかの値になります。 - `application/atom+xml` - `application/json;odata=nometadata` - `application/json;odata=minimalmetadata` - `application/json;odata=fullmetadata` 有効なコンテンツタイプの詳細については、「 Table Storage 操作のペイロード形式」を参照してください。
`x-ms-client-request-id`	要求と対応する応答のトラブルシューティングに使用できます。このヘッダーの値は、要求に存在し、その値が最大 1,024 文字の可視 ASCII 文字である場合、ヘッダーの値 `x-ms-client-request-id` と等しくなります。ヘッダーが `x-ms-client-request-id` 要求に存在しない場合、このヘッダーは応答に存在しません。

応答本文

Query Tables 操作は、アカウント内のテーブルの一覧を OData エンティティセットで返します。ヘッダーの Accept 値に従って、コンテンツは JSON または Atom フィードです。

注意

ペイロード形式として JSON をお勧めします。バージョン 2015-12-11 以降でサポートされている唯一の形式です。

JSON (バージョン 2013-08-15 以降)

完全なメタデータを含む操作のサンプル JSON 応答本文を Query Tables 次に示します。

{  
   "odata.metadata":"https://myaccount.table.core.windows.net/$metadata#Tables",  
   "value":[  
      {  
         "odata.type":"myaccount.Tables",  
         "odata.id":"https://myaccount.table.core.windows.net/Tables('mytable')",  
         "odata.editLink":"Tables('mytable')",  
         "TableName":"mytable"  
      }  
}

最小限のメタデータを含む操作のサンプル JSON 応答本文を Query Tables 次に示します。

{  
    "odata.metadata":"https://myaccount.table.core.windows.net/$metadata#Tables",  
    "value":[{  
        "TableName":"mytable"  
    }]  
}

メタデータのない操作のサンプル JSON 応答本文を Query Tables 次に示します。

{  
   "value":[{  
       "TableName":"mytable"  
   },  
}

Atom フィード (2015-12-11 より前のバージョン)

操作の Atom 応答本文の例を次に Query Tables 示します。

<?xml version="1.0" encoding="utf-8" standalone="yes"?>  
<feed xml:base="https://myaccount.table.core.windows.net/" xmlns:d="http://schemas.microsoft.com/ado/2007/08/dataservices" xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata" xmlns="http://www.w3.org/2005/Atom">  
  <title type="text">Tables</title>  
  <id>https://myaccount.table.core.windows.net/Tables</id>  
  <updated>2009-01-04T17:18:54.7062347Z</updated>  
  <link rel="self" title="Tables" href="Tables" />  
  <entry>  
    <id>https://myaccount.table.core.windows.net/Tables('mytable')</id>  
    <title type="text"></title>  
    <updated>2009-01-04T17:18:54.7062347Z</updated>  
    <author>  
      <name />  
    </author>  
    <link rel="edit" title="Tables" href="Tables('mytable')" />  
    <category term="myaccount.Tables" scheme="http://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />  
    <content type="application/xml">  
      <m:properties>  
        <d:TableName>mytable</d:TableName>  
      </m:properties>  
    </content>  
  </entry>  
</feed>

承認

この操作を呼び出すことができるのは、アカウント所有者だけです。

注釈

Table Storage に対するクエリでは、一度に最大 1,000 個のテーブルを返し、最大 5 秒間実行できます。応答には、次のいずれかの場合に継続トークンを x-ms-continuation-NextTableName 含むカスタムヘッダーが含まれています。

結果セットには、1,000 を超えるテーブルが含まれています。
クエリが 5 秒以内に終了しませんでした。
クエリがパーティション境界を越えている。

継続を使用して、データの次のページに対する後続の要求を作成できます。継続トークンの詳細については、「クエリのタイムアウトと改ページ」を参照してください。

注意

継続トークンを含む後続の要求を行う場合は、要求で元の URI を必ず渡してください。たとえば、元の要求の一部として、$select、または $top クエリオプションを指定$filterした場合は、後続の要求にそのオプションを含めます。そうしないと、後続の要求で予期しない結果が返される可能性があります。

この場合のクエリオプションは $top 、ページあたりの結果の最大数を指定します。応答セット全体の結果の最大数は指定されません。

詳細については、「クエリテーブルとエンティティ」を参照してください。

クエリのスケジュール設定と処理の要求に割り当てられた合計時間は 30 秒です。この合計には、クエリ実行の 5 秒が含まれます。

LINQ を使用した Table Storage に対してサポートされているクエリ操作の詳細については、「Table Storage でサポートされるクエリ演算子」および「Table Storage に対する LINQ クエリの記述」を参照してください。

次の方法で共有

テーブルの照会

要求

エミュレートされたストレージサービス URI

URI パラメーター

要求ヘッダー

要求本文

[応答]

状態コード

応答ヘッダー

応答本文

JSON (バージョン 2013-08-15 以降)

Atom フィード (2015-12-11 より前のバージョン)

承認

注釈

関連項目

その他のリソース

次の方法で共有

テーブルの照会

要求

エミュレートされたストレージ サービス URI

URI パラメーター

要求ヘッダー

要求本文

[応答]

状態コード

応答ヘッダー

応答本文

JSON (バージョン 2013-08-15 以降)

Atom フィード (2015-12-11 より前のバージョン)

承認

注釈

関連項目

その他のリソース

エミュレートされたストレージサービス URI