Share via

Catalog - Preview Table Partition

  • 參考
Service:
Data Lake Analytics
API Version:
2016-11-01

擷取指定資料分割中的一組預覽數據列。

GET https://{accountName}.{adlaCatalogDnsSuffix}/catalog/usql/databases/{databaseName}/schemas/{schemaName}/tables/{tableName}/partitions/{partitionName}/previewrows?api-version=2016-11-01
With optional parameters: 
GET https://{accountName}.{adlaCatalogDnsSuffix}/catalog/usql/databases/{databaseName}/schemas/{schemaName}/tables/{tableName}/partitions/{partitionName}/previewrows?maxRows={maxRows}&maxColumns={maxColumns}&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

包含數據分割的資料庫名稱。
partitionName
 path True

string

數據表分割區的名稱。
schemaName
 path True

string

包含數據分割的架構名稱。
tableName
 path True

string

包含數據分割的數據表名稱。
api-version
 query True

string

用戶端 API 版本。
maxColumns
 query

integer

int64

要擷取的數據行數目上限。
maxRows
 query

integer

int64

要擷取的預覽數據列數目上限。傳回的數據列可能會小於或等於這個數字，視數據分割中的數據列大小和數據列數目而定。

回應

名稱 類型 Description
200 OK

USqlTablePreview

已成功擷取指定數據分割的預覽數據列。

範例

Retrieves a preview set of rows in given partition

Sample Request

GET https://contosoadla.azuredatalakeanalytics.net/catalog/usql/databases/master/schemas/dbo/tables/test_table_name/partitions/test_partition_name/previewrows?api-version=2016-11-01

Sample Response

Status code:
200 
{
  "totalRowCount": 1,
  "totalColumnCount": 2,
  "rows": [
    [
      "value_a",
      "value_b"
    ]
  ],
  "truncated": false,
  "schema": [
    {
      "name": "test_column_name",
      "type": "test_data_type"
    }
  ]
}

定義

名稱 Description
USqlTableColumn

Data Lake Analytics 目錄 U-SQL 資料表資料行專案。
USqlTablePreview

Data Lake Analytics 目錄數據表或數據分割預覽數據列專案。

USqlTableColumn

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

名稱 類型 Description
name

string

數據表中數據行的名稱。
type

string

指定數據行的物件類型 (，例如 System.String) 。

USqlTablePreview

Data Lake Analytics 目錄數據表或數據分割預覽數據列專案。

名稱 類型 Description
rows

string[]

數據表或數據分割預覽的數據列，其中每個數據列都是字串陣列，表示數據列的值。 注意：位元組陣列會顯示為base-64編碼值，SqlMap 和 SqlArray 物件會顯示為逸出 JSON 物件，而 DateTime 物件會顯示為 ISO 格式的 UTC 日期時間。
schema

USqlTableColumn[]

數據表或分割區的架構。
totalColumnCount

integer

數據表或數據分割中的數據行總數。
totalRowCount

integer

數據表或數據分割中的數據列總數。
truncated

boolean

如果回應中的數據量低於預期，則為 true，因為預覽作業的大小限制。 如果要求的數據列或數據列計數太大，就會發生這種情況。