Catalog - Preview Table
擷取指定數據表中的一組預覽數據列。
GET https://{accountName}.{adlaCatalogDnsSuffix}/catalog/usql/databases/{databaseName}/schemas/{schemaName}/tables/{tableName}/previewrows?api-version=2016-11-01
GET https://{accountName}.{adlaCatalogDnsSuffix}/catalog/usql/databases/{databaseName}/schemas/{schemaName}/tables/{tableName}/previewrows?maxRows={maxRows}&maxColumns={maxColumns}&api-version=2016-11-01
URI 參數
名稱 | 位於 | 必要 | 類型 | Description |
---|---|---|---|---|
account
|
path | True |
string |
要在其中執行目錄作業的 Azure Data Lake Analytics 帳戶。 |
adla
|
path | True |
string |
取得作為所有 Azure Data Lake Analytics 目錄服務要求基底的 DNS 後綴。 |
database
|
path | True |
string |
包含數據表的資料庫名稱。 |
schema
|
path | True |
string |
包含數據表的架構名稱。 |
table
|
path | True |
string |
資料表的名稱。 |
api-version
|
query | True |
string |
用戶端 API 版本。 |
max
|
query |
integer int64 |
要擷取的數據行數目上限。 |
|
max
|
query |
integer int64 |
要擷取的預覽數據列數目上限。 傳回的數據列可能會小於或等於這個數字,視數據表中的數據列大小和數據列數目而定。 |
回應
名稱 | 類型 | Description |
---|---|---|
200 OK |
已成功擷取指定數據表的預覽數據列。 |
範例
Retrieves a preview set of rows in given table
Sample Request
GET https://contosoadla.azuredatalakeanalytics.net/catalog/usql/databases/master/schemas/dbo/tables/test_table_name/previewrows?api-version=2016-11-01
Sample Response
{
"totalRowCount": 1,
"totalColumnCount": 2,
"rows": [
[
"value_a",
"value_b"
]
],
"truncated": false,
"schema": [
{
"name": "test_column_name",
"type": "test_data_type"
}
]
}
定義
名稱 | Description |
---|---|
USql |
Data Lake Analytics 目錄 U-SQL 資料表資料行專案。 |
USql |
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 |
數據表或分割區的架構。 |
|
totalColumnCount |
integer |
數據表或數據分割中的數據行總數。 |
totalRowCount |
integer |
數據表或數據分割中的數據列總數。 |
truncated |
boolean |
如果回應中的數據量低於預期,則為 true,因為預覽作業的大小限制。 如果要求的數據列或數據列計數太大,就會發生這種情況。 |