テーブルの照会

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

Request

Query Tables 要求の構成は次のとおりです。 HTTPS が推奨されます。 myaccount をストレージ アカウントの名前に置き換えます。

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

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

エミューレートされたストレージ サービスに対する要求では、エミュレーターのホスト名と Table Service ポートを 127.0.0.1:10002 と指定し、その後にエミューレートされたストレージ アカウント名を指定します。

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

エミュレートされたストレージ サービスのテーブル サービスは、Windows® Azure™ のテーブル サービスとはいくつかの点で異なります。 詳細については、「Storage EmulatorサービスとAzure Storage サービスの違い」を参照してください。

URI パラメーター

Query Tables 操作は、OData プロトコル仕様で定義されているクエリ オプションをサポートしています。 詳細については、「 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 Service 操作のペイロード形式」を参照してください
x-ms-client-request-id 省略可能。 ストレージ分析ログが有効になっているときに分析ログに記録される 1 KiB 文字制限を持つ、クライアントによって生成された不透明な値を提供します。 クライアント側のアクティビティをサーバーが受信した要求と関連付けるには、このヘッダーを使用することが強く推奨されます。 詳細については、「Azure ログ記録のStorage AnalyticsWindows: ログを使用したStorage要求の追跡」を参照してください。

要求本文

[なし] :

応答

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

状態コード

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

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

レスポンス ヘッダー

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

応答ヘッダー 説明
x-ms-continuation-NextTableName 返されるテーブルの数が 1,000 個を超える場合、またはクエリがタイムアウト間隔内に完了しない場合は、応答ヘッダーに x-ms-continuation-NextTableName 継続ヘッダーが含まれます。 このヘッダーは、継続トークンの値を返します。 継続トークンの使用の詳細については、「 クエリのタイムアウトと改ページ位置」を参照してください。
x-ms-request-id このヘッダーは要求を一意に識別するので、要求のトラブルシューティングに使用できます。 詳細については、「 API 操作のトラブルシューティング」を参照してください
x-ms-version 要求の実行に使用するテーブル サービスのバージョンを示します。 このヘッダーはバージョン 2009-09-19 以降で行った要求に対して返されます。
Date サービスによって生成される、応答の開始時刻を示す UTC 日付/時刻値。
Content-Type ペイロードのコンテンツの種類を示します。 値は、要求 Accept ヘッダーによって異なります。 次のいずれかの値になります。

- application/atom+xml
- application/json;odata=nometadata
- application/json;odata=minimalmetadata
- application/json;odata=fullmetadata

有効なコンテンツ タイプの詳細については、「 Table Service 操作のペイロード形式」を参照してください。
x-ms-client-request-id このヘッダーは、要求と対応する応答のトラブルシューティングに使用できます。 このヘッダーの値は、要求に存在し、その値 x-ms-client-request-id が最大 1024 文字の ASCII 文字で表示される場合、ヘッダーの値と同じです。 ヘッダーが x-ms-client-request-id 要求に存在しない場合、このヘッダーは応答に存在しません。

応答本文

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

Note

JSON は推奨されるペイロード形式であり、バージョン 2015-12-11 以降でサポートされている唯一の形式です。

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

次の例は、Query Tables 操作の JSON 応答本文です。

完全なメタデータ

{  
   "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"  
      }  
}  

最小メタデータ

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

メタデータなし

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

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

次の例は、Query Tables 操作の Atom 応答本文です。

<?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 Service に対するクエリは最長 5 秒間実行され、一度に最大 1,000 個のテーブルが返されます。 返されるテーブル数が 1,000 個を超える場合、クエリが 5 秒以内に終了しない場合、またはクエリがパーティション境界を超える場合は、x-ms-continuation-NextTableName 継続トークンを含むカスタム ヘッダーが応答に含まれます。 この継続トークンを使用して、引き続き次のデータ ページを要求できます。 継続トークンの詳細については、「 クエリのタイムアウトと改ページ位置」を参照してください。

注意

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

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

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

クエリのスケジュール設定および処理用として要求に割り当てられる時間は、クエリの実行に要する 5 秒を含め、合計で 30 秒間です。

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

参照

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