Catalog - List Tables

Referencia

Szolgáltatás:: Data Lake Analytics

API-verzió:: 2016-11-01

Lekéri a táblák listáját a Data Lake Analytics-katalógusból.

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

Opcionális paraméterekkel:

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
accountName	path	True	string	Az Azure Data Lake Analytics-fiók, amelyen katalógusműveleteket hajthat végre.
adlaCatalogDnsSuffix	path	True	string	Lekéri az Azure Data Lake Analytics-katalógus szolgáltatáskéréseinek alapjaként használt DNS-utótagot.
databaseName	path	True	string	A táblákat tartalmazó adatbázis neve.
schemaName	path	True	string	A táblákat tartalmazó séma neve.
api-version	query	True	string	Ügyfél API-verziója.
$count	query		boolean	Az igaz vagy hamis logikai érték, amely a válaszban szereplő erőforrásokhoz tartozó egyező erőforrások számának lekéréséhez kérhető, például Kategóriák?$count=igaz. Opcionális.
$filter	query		string	OData-szűrő. Opcionális.
$orderby	query		string	OrderBy záradék. Egy vagy több vesszővel tagolt kifejezés választható "asc" (alapértelmezett) vagy "desc" értékkel attól függően, hogy milyen sorrendben szeretné rendezni az értékeket, például Kategóriák?$orderby=CategoryName desc. Opcionális.
$select	query		string	OData Select utasítás. Az egyes bejegyzések tulajdonságait csak a kért értékekre korlátozza, például Kategóriák?$select=CategoryName,Description. Opcionális.
$skip	query		integer (int32) minimum: 1	Az elemek visszaadása előtt kihagyandó elemek száma. Opcionális.
$top	query		integer (int32) minimum: 1	A visszaadni kívánt elemek száma. Opcionális.
basic	query		boolean	Az alapkapcsoló azt jelzi, hogy milyen szintű információt kell visszaadni a táblák listázásakor. Ha az alapszintű érték igaz, csak database_name, schema_name, table_name és verziószám lesz visszaadva az egyes táblákhoz, ellenkező esetben minden tábla metaadatait visszaadja a rendszer. Alapértelmezés szerint hamis. Opcionális.

Válaszok

Name	Típus	Description
200 OK	USqlTableList	Sikeresen lekérte a táblák listáját a megadott adatbázisban és sémában.

Példák

Retrieves the list of tables from the Data Lake Analytics catalog

Mintakérelem

HTTP

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

Mintaválasz

Állapotkód:: 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",
      "tableName": "test_table_name",
      "columnList": [
        {
          "name": "test_column_name",
          "type": "test_type"
        }
      ],
      "indexList": [
        {
          "name": "test_index_name",
          "indexKeys": [
            {
              "name": "test_index_key",
              "descending": false
            }
          ],
          "columns": [
            "test_column"
          ],
          "distributionInfo": {
            "type": 1,
            "keys": [
              {
                "name": "test_key",
                "descending": false
              }
            ],
            "count": 1,
            "dynamicCount": 1
          },
          "partitionFunction": "34adfa4f-cedf-4dc0-ba29-b6d1a69ab346",
          "partitionKeyList": [
            "test_partition_key"
          ],
          "streamNames": [
            "test_stream_name"
          ],
          "isColumnstore": false,
          "indexId": 1,
          "isUnique": false
        }
      ],
      "partitionKeyList": [
        "test_partition_key"
      ],
      "externalTable": {
        "tableName": "test_table_name",
        "dataSource": {
          "name": {
            "firstPart": "test_first_part",
            "secondPart": "test_second_part",
            "thirdPart": "test_third_part",
            "server": "test_server"
          },
          "version": "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345"
        }
      },
      "distributionInfo": {
        "type": 1,
        "keys": [
          {
            "name": "test_key",
            "descending": false
          }
        ],
        "count": 1,
        "dynamicCount": 1
      }
    }
  ]
}

Definíciók

Name	Description
DdlName	Egy Data Lake Analytics DDL-névelem.
EntityId	Egy Data Lake Analytics-katalógus entitásazonosító objektuma.
ExternalTable	A Data Lake Analytics-katalógus külső táblázateleme.
USqlDirectedColumn	Egy Data Lake Analytics-katalógus U-SQL által irányított oszlopeleme.
USqlDistributionInfo	Egy Data Lake Analytics-katalógus U-SQL terjesztési információs objektuma.
USqlIndex	Egy Data Lake Analytics-katalógus U-SQL-tábla indexeleme.
USqlTable	Egy Data Lake Analytics-katalógus U-SQL-táblaeleme.
USqlTableColumn	Egy Data Lake Analytics-katalógus U-SQL táblaoszlopeleme.
USqlTableList	A Data Lake Analytics-katalógus U-SQL-táblázatelem-listája.

DdlName

Objektum

Egy Data Lake Analytics DDL-névelem.

Name	Típus	Description
firstPart	string	az adatbázishoz és a sémához társított tábla neve.
secondPart	string	az adatbázishoz és a sémához társított tábla neve.
server	string	az adatbázishoz és a sémához társított tábla neve.
thirdPart	string	az adatbázishoz és a sémához társított tábla neve.

EntityId

Objektum

Egy Data Lake Analytics-katalógus entitásazonosító objektuma.

Name	Típus	Description
name	DdlName	az adatbázishoz, sémához és táblához társított külső tábla neve.
version	string (uuid)	a külső adatforrás verziója.

ExternalTable

Objektum

A Data Lake Analytics-katalógus külső táblázateleme.

Name	Típus	Description
dataSource	EntityId	a külső táblához társított adatforrás.
tableName	string	az adatbázishoz és a sémához társított tábla neve.

USqlDirectedColumn

Objektum

Egy Data Lake Analytics-katalógus U-SQL által irányított oszlopeleme.

Name	Típus	Description
descending	boolean	a kapcsoló jelzi, hogy az index csökkenő vagy sem.
name	string	a tábla indexének neve.

USqlDistributionInfo

Objektum

Egy Data Lake Analytics-katalógus U-SQL terjesztési információs objektuma.

Name	Típus	Description
count	integer (int32)	az ezen eloszlást használó indexek száma.
dynamicCount	integer (int32)	a eloszlást használó indexek dinamikus száma.
keys	USqlDirectedColumn[]	a terjesztési irányban lévő oszlopok listája
type	integer (int32)	a disztribúció típusa.

USqlIndex

Objektum

Egy Data Lake Analytics-katalógus U-SQL-tábla indexeleme.

Name	Típus	Description
columns	string[]	az index oszlopainak listája
distributionInfo	USqlDistributionInfo	az index disztribúciós adatai
indexId	integer (int32)	az index azonosítója a táblában.
indexKeys	USqlDirectedColumn[]	az indexben lévő irányított oszlopok listája
isColumnstore	boolean	a kapcsoló, amely azt jelzi, hogy ez az index oszlopcentrikus index-e.
isUnique	boolean	a kapcsoló, amely azt jelzi, hogy ez az index egyedi index-e.
name	string	a tábla indexének neve.
partitionFunction	string (uuid)	partíciófüggvény azonosítója az indexhez.
partitionKeyList	string[]	a partíciókulcsok listája az indexben
streamNames	string[]	az indexet tartalmazó adatfolyamok teljes elérési útjainak listája a DataLake-fiókban.

USqlTable

Objektum

Egy Data Lake Analytics-katalógus U-SQL-táblaeleme.

Name	Típus	Description
columnList	USqlTableColumn[]	a táblázat oszlopainak listája
computeAccountName	string	a Data Lake Analytics-fiók neve.
databaseName	string	az adatbázis neve.
distributionInfo	USqlDistributionInfo	a tábla disztribúciós adatai
externalTable	ExternalTable	a táblához társított külső tábla.
indexList	USqlIndex[]	a táblázatban szereplő indexek listája
partitionKeyList	string[]	a tábla partíciókulcsainak listája
schemaName	string	a táblához és adatbázishoz társított séma neve.
tableName	string	a tábla neve.
version	string (uuid)	a katalóguselem verziója.

USqlTableColumn

Objektum

Egy Data Lake Analytics-katalógus U-SQL táblaoszlopeleme.

Name	Típus	Description
name	string	a tábla oszlopának neve.
type	string	a megadott oszlop objektumtípusa (például System.String).

USqlTableList

Objektum

A Data Lake Analytics-katalógus U-SQL-táblázatelem-listája.

Name	Típus	Description
nextLink	string	a következő találatoldalra mutató hivatkozás.
value	USqlTable[]	az adatbázis és a sémakombináció tábláinak listája

Megosztás a következőn keresztül:

Catalog - List Tables

URI-paraméterek

Válaszok

Példák

Retrieves the list of tables from the Data Lake Analytics catalog

Mintakérelem

Mintaválasz

Definíciók

DdlName

EntityId

ExternalTable

USqlDirectedColumn

USqlDistributionInfo

USqlIndex

USqlTable

USqlTableColumn

USqlTableList