Поделиться через

Tables - List Tables

Служба:
Lakehouse
Версия API:
v1

Возвращает список таблиц Lakehouse.

Note

Этот API является частью предварительного выпуска и предоставляется только для оценки и разработки. Он может измениться на основе отзывов и не рекомендуется для использования в рабочей среде.

This API supports pagination.

Обязательные делегированные области

Lakehouse.Read.All или Lakehouse.ReadWrite.All

Поддерживаемые удостоверения Microsoft Entra

This API supports the Microsoft identities listed in this section.

Identity Support
User Yes
Service principal and Managed identities Yes

Interface

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/lakehouses/{lakehouseId}/tables
С использованием необязательных параметров: 
GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/lakehouses/{lakehouseId}/tables?maxResults={maxResults}&continuationToken={continuationToken}

Параметры URI

Имя В Обязательно Тип Описание
lakehouseId
 path True

string (uuid)

Идентификатор lakehouse.
workspaceId
 path True

string (uuid)

Идентификатор рабочей области.
continuationToken
 query

string

Маркер для получения следующей страницы результатов, если он доступен.
maxResults
 query

integer (int32)

minimum: 1
maximum: 100

Максимальное количество результатов на страницу, возвращаемое.

Ответы

Имя Тип Описание
200 OK

Tables

Запрос успешно завершен.
Other Status Codes

ErrorResponse

Распространенные коды ошибок:

  • UnknownError — произошла ошибка.

Примеры

List tables example

Образец запроса

GET https://api.fabric.microsoft.com/v1/workspaces/f089354e-8366-4e18-aea3-4cb4a3a50b48/lakehouses/41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87/tables?maxResults=10&continuationToken=

Пример ответа

Код состояния:
200 
{
  "continuationToken": "+RID:~HTsuAOseYicH-GcAAAAAAA==#RT:1#TRC:1#ISV:2#IEO:65567#QCF:8#FPC:AgKfAZ8BnwEEAAe8eoA=",
  "continuationUri": "https://api.fabric.microsoft.com/v1/workspaces/f089354e-8366-4e18-aea3-4cb4a3a50b48/lakehouses/41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87/tables?continuationToken=%2BRID%3A~HTsuAOseYicH-GcAAAAAAA%3D%3D%23RT%3A1%23TRC%3A1%23ISV%3A2%23IEO%3A65567%23QCF%3A8%23FPC%3AAgKfAZ8BnwEEAAe8eoA%3D",
  "data": [
    {
      "type": "Managed",
      "name": "Table1",
      "location": "abfss://f089354e-8366-4e18-aea3-4cb4a3a50b48@onelake.dfs.fabric.microsoft.com/41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87/Tables/Table1",
      "format": "Delta"
    }
  ]
}

Определения

Имя Описание
ErrorRelatedResource

Объект сведений об ошибках, связанных с ресурсом.
ErrorResponse

Ответ на ошибку.
ErrorResponseDetails

Сведения об ответе на ошибку.
Table

Table information.
Tables

Список таблиц с разбивкой на страницы.
TableType

Тип таблицы. С течением времени могут добавляться дополнительные TableType типы.

ErrorRelatedResource

Object

Объект сведений об ошибках, связанных с ресурсом.

Имя Тип Описание
resourceId

string

Идентификатор ресурса, участвующий в ошибке.
resourceType

string

Тип ресурса, который участвует в ошибке.

ErrorResponse

Object

Ответ на ошибку.

Имя Тип Описание
errorCode

string

Определенный идентификатор, предоставляющий сведения об условии ошибки, что позволяет стандартизировать обмен данными между службой и ее пользователями.
message

string

Удобочитаемое представление ошибки.
moreDetails

ErrorResponseDetails[]

Список дополнительных сведений об ошибке.
relatedResource

ErrorRelatedResource

Сведения об ошибках, связанных с ресурсом.
requestId

string

Идентификатор запроса, связанного с ошибкой.

ErrorResponseDetails

Object

Сведения об ответе на ошибку.

Имя Тип Описание
errorCode

string

Определенный идентификатор, предоставляющий сведения об условии ошибки, что позволяет стандартизировать обмен данными между службой и ее пользователями.
message

string

Удобочитаемое представление ошибки.
relatedResource

ErrorRelatedResource

Сведения об ошибках, связанных с ресурсом.

Table

Object

Table information.

Имя Тип Описание
format

string

Table format.
location

string

Table location.
name

string

Table name.
type

TableType

Table type.

Tables

Object

Список таблиц с разбивкой на страницы.

Имя Тип Описание
continuationToken

string

Маркер для получения следующей страницы результатов.
continuationUri

string

URI следующего блока в результирующем наборе.
data

Table[]

Список таблиц.

TableType

Перечисление

Тип таблицы. С течением времени могут добавляться дополнительные TableType типы.

Значение Описание
Managed

Managed table.
External

External table.