Share via


Catalog - List Databases

從 Data Lake Analytics 目錄擷取資料庫清單。

GET https://{accountName}.{adlaCatalogDnsSuffix}/catalog/usql/databases?api-version=2016-11-01
GET https://{accountName}.{adlaCatalogDnsSuffix}/catalog/usql/databases?$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 後綴。

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

USqlDatabaseList

已成功擷取資料庫清單。

範例

Retrieves the list of databases from the Data Lake Analytics catalog

Sample Request

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

Sample Response

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

定義

名稱 Description
USqlDatabase

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

USqlDatabaseList

Data Lake Analytics 目錄 U-SQL 資料庫項目清單。

USqlDatabase

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

名稱 類型 Description
computeAccountName

string

Data Lake Analytics 帳戶的名稱。

databaseName

string

資料庫的名稱。

version

string

目錄專案的版本。

USqlDatabaseList

Data Lake Analytics 目錄 U-SQL 資料庫項目清單。

名稱 類型 Description
nextLink

string

結果下一頁的連結。

value

USqlDatabase[]

資料庫清單