Catalog - List Table Partitions

Service:

Data Lake Analytics

API Version:

2016-11-01

從 Data Lake Analytics 目錄擷取數據表分割的清單。

GET https://{accountName}.{adlaCatalogDnsSuffix}/catalog/usql/databases/{databaseName}/schemas/{schemaName}/tables/{tableName}/partitions?api-version=2016-11-01

With optional parameters:

GET https://{accountName}.{adlaCatalogDnsSuffix}/catalog/usql/databases/{databaseName}/schemas/{schemaName}/tables/{tableName}/partitions?$filter={$filter}&$top={$top}&$skip={$skip}&$select={$select}&$orderby={$orderby}&$count={$count}&api-version=2016-11-01

URI 參數

名稱	位於	必要	類型	Description
accountName	path	True	string	要在其中執行目錄作業的 Azure Data Lake Analytics 帳戶。
adlaCatalogDnsSuffix	path	True	string	取得作為所有 Azure Data Lake Analytics 目錄服務要求的基底的 DNS 後綴。
databaseName	path	True	string	包含數據分割的資料庫名稱。
schemaName	path	True	string	包含數據分割的架構名稱。
tableName	path	True	string	包含數據分割的數據表名稱。
api-version	query	True	string	用戶端 API 版本。
$count	query		boolean	true 或 false 的布爾值，要求響應中資源所包含的相符資源計數，例如 Categories？$count=true。 選擇性。
$filter	query		string	OData 篩選條件。 選擇性。
$orderby	query		string	OrderBy 子句。 一或多個逗號分隔表達式，使用選擇性的 “asc” (預設) 或 “desc”，視您想要排序值的順序而定，例如 Category？$orderby=CategoryName desc。 選擇性。
$select	query		string	OData Select 語句。 將每個專案上的屬性限制為只要求的屬性，例如 Categories？$select=CategoryName，Description。 選擇性。
$skip	query		integer int32	傳回專案之前要略過的項目數。 選擇性。
$top	query		integer int32	要傳回的項目數。 選擇性。

回應

名稱	類型	Description
200 OK	USqlTablePartitionList	已成功擷取指定資料庫、架構和數據表中的數據表數據分割清單。

範例

Retrieves the list of table partitions from the Data Lake Analytics catalog

Sample Request

HTTP

GET https://contosoadla.azuredatalakeanalytics.net/catalog/usql/databases/master/schemas/dbo/tables/test_table_name/partitions?$filter=test_filter&$top=1&$skip=1&$select=test_select&$orderby=test_orderby&$count=False&api-version=2016-11-01

Sample Response

Status code:

200

{
  "nextLink": "https://contosoadla.datalakeanalytics.net/catalog/usql/databases/master/schema/dbo/statistics?api-version=2016-11-01&%24skiptoken=<token>",
  "value": [
    {
      "computeAccountName": "contosoadla",
      "version": "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345",
      "databaseName": "master",
      "schemaName": "dbo",
      "partitionName": "test_partition_name",
      "parentName": "test_parent_name",
      "indexId": 1,
      "label": [
        "test_label_1",
        "test_label_2"
      ],
      "createDate": "2017-04-14T13:21:56.6819037-07:00"
    }
  ]
}

定義

名稱	Description
DdlName	Data Lake Analytics DDL 名稱專案。
USqlTablePartition	Data Lake Analytics 目錄 U-SQL 資料表分割專案。
USqlTablePartitionList	Data Lake Analytics 目錄 U-SQL 資料表分割項目清單。

DdlName

Data Lake Analytics DDL 名稱專案。

名稱	類型	Description
firstPart	string	與此資料庫和架構相關聯的數據表名稱。
secondPart	string	與此資料庫和架構相關聯的數據表名稱。
server	string	與此資料庫和架構相關聯的數據表名稱。
thirdPart	string	與此資料庫和架構相關聯的數據表名稱。

USqlTablePartition

Data Lake Analytics 目錄 U-SQL 資料表分割專案。

名稱	類型	Description
computeAccountName	string	Data Lake Analytics 帳戶的名稱。
createDate	string	分割區的建立時間
databaseName	string	資料庫的名稱。
indexId	integer	此數據分割的索引識別碼。
label	string[]	與此分割區相關聯的標籤清單。
parentName	DdlName	數據分割父系的 Ddl 物件。
partitionName	string	數據表分割區的名稱。
schemaName	string	與此數據表分割和資料庫相關聯的架構名稱。
version	string	目錄專案的版本。

USqlTablePartitionList

Data Lake Analytics 目錄 U-SQL 資料表分割項目清單。

名稱	類型	Description
nextLink	string	結果下一頁的連結。
value	USqlTablePartition[]	資料庫中數據表數據分割的清單、架構和數據表組合