次の方法で共有


テーブルの照会

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 TablesOData プロトコル仕様 で定義されているクエリ オプションがサポートされます。

要求ヘッダー

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

要求ヘッダー 説明
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 クエリの記述」を参照してください。

関連項目

Table Storage リソースのアドレス指定
Azure Storage への要求を承認する
OData データ サービスのバージョン ヘッダーを設定する
状態コードとエラー コード
Table Storage のエラー コード