Power Query: коннекторы

Подключение к Postgres, SQL Server, OData и веб-источникам: проверка связи, предпросмотр, навигация по объектам. Термины — в глоссарии.

Операции на этой странице — 13

• evaluate_power_query_odata_feed_transform
• evaluate_power_query_postgres_transform
• evaluate_power_query_sqlserver_transform
• evaluate_power_query_transform
• evaluate_power_query_web_connector_transform
• pq_postgres_cancel
• pq_postgres_list_navigation
• pq_postgres_preview
• pq_postgres_test_connection
• pq_sqlserver_cancel
• pq_sqlserver_list_navigation
• pq_sqlserver_preview
• pq_sqlserver_test_connection

evaluate_power_query_odata_feed_transform

Вычисляет/оценивает power query odata feed transform.

Запрос

Поле	Тип TypeScript	Обяз.
operation	"evaluate_power_query_odata_feed_transform"	да
mSource	string	да
connector	ApprovedODataFeedDescriptor	нет
destination	PowerQueryLoadDestination	нет
refreshQueryId	string	нет
requestedBackend	ComputeBackendKind | null	нет

Ответ при успехе · evaluate_power_query_odata_feed_transform

Поле	Тип TypeScript	Обяз.
operation	"evaluate_power_query_odata_feed_transform"	да
outcome	ContractPowerQueryTransformOutcome	да
loadPlan	PowerQueryLoadPlan	нет

Минимальный JSON-шаблон

{
  "operation": "evaluate_power_query_odata_feed_transform",
  "mSource": "<string>",
  "requestedBackend": "native-desktop"
}

evaluate_power_query_postgres_transform

Вычисляет/оценивает power query postgres transform.

Запрос

Поле	Тип TypeScript	Обяз.
operation	"evaluate_power_query_postgres_transform"	да
descriptor	PqPostgresDialogDescriptor	нет
table	PqPostgresPreviewTableRef	нет
mSource	string	нет
destination	PowerQueryLoadDestination	нет
refreshQueryId	string	нет
connectUser	string	нет
lanGrants	PqPostgresLanGrantWire[]	нет
privacy	PqPrivacyEvaluationInput	нет
requestedBackend	ComputeBackendKind | null	нет

Ответ при успехе · evaluate_power_query_postgres_transform

Поле	Тип TypeScript	Обяз.
operation	"evaluate_power_query_postgres_transform"	да
outcome	ContractPowerQueryTransformOutcome	да
loadPlan	PowerQueryLoadPlan	нет

Минимальный JSON-шаблон

{
  "operation": "evaluate_power_query_postgres_transform",
  "requestedBackend": "native-desktop"
}

evaluate_power_query_sqlserver_transform

Вычисляет/оценивает power query sqlserver transform.

Запрос

Поле	Тип TypeScript	Обяз.
operation	"evaluate_power_query_sqlserver_transform"	да
descriptor	PqSqlServerDescriptor	нет
table	PqSqlServerTableRef	нет
destination	PowerQueryLoadDestination	нет
refreshQueryId	string	нет
privacy	PqPrivacyEvaluationInput	нет
requestedBackend	ComputeBackendKind | null	нет

Ответ при успехе · evaluate_power_query_sqlserver_transform

Поле	Тип TypeScript	Обяз.
operation	"evaluate_power_query_sqlserver_transform"	да
outcome	ContractPowerQueryTransformOutcome	да
loadPlan	PowerQueryLoadPlan	нет

Минимальный JSON-шаблон

{
  "operation": "evaluate_power_query_sqlserver_transform",
  "requestedBackend": "native-desktop"
}

evaluate_power_query_transform

Вычисляет/оценивает power query transform.

Запрос

Поле	Тип TypeScript	Обяз.	Примечание из контракта
operation	"evaluate_power_query_transform"	да
mSource	string	да
sourceId	string	да
sourceUri	string	нет
sourceKind	"csv" | “workbook” | “folder” | “json” | “xml”	нет	Для csv и workbook — справочное значение, оно и так выводится из запроса. Для folder — значащее: именно оно направляет обработку по пути объединения файлов папки, а не одиночного файла.
previewStep	number	нет	Intermediate-step preview (same semantics as every other Power Query source).
destination	PowerQueryLoadDestination	нет	Необязательное место загрузки результата. Без поля — просмотр без изменений и без плана. С полем — тоже просмотр, но в ответе приходит проверенный план загрузки в loadPlan; сама загрузка не выполняется.
includeDependencyGraph	boolean	нет
paramOptions	ContractPersistedParamOptionsBinding	нет
requestedBackend	ComputeBackendKind | null	нет

Ответ при успехе · evaluate_power_query_transform

Поле	Тип TypeScript	Обяз.	Примечание из контракта
operation	"evaluate_power_query_transform"	да
outcome	ContractPowerQueryTransformOutcome	да
loadPlan	PowerQueryLoadPlan	нет	Есть в ответе, только если запрос содержал место загрузки и вычисление прошло. При обычном просмотре и при отказе поля нет. Данные при этом никуда не записываются.
recomputed	boolean	нет
dependencyGraph	ContractDependencyGraphSnapshot | null	нет

Минимальный JSON-шаблон

{
  "operation": "evaluate_power_query_transform",
  "mSource": "<string>",
  "sourceId": "<string>",
  "requestedBackend": "native-desktop"
}

evaluate_power_query_web_connector_transform

Вычисляет/оценивает power query web connector transform.

Запрос

Поле	Тип TypeScript	Обяз.
operation	"evaluate_power_query_web_connector_transform"	да
mSource	string	да
connector	ApprovedWebConnectorDescriptor	нет
destination	PowerQueryLoadDestination	нет
refreshQueryId	string	нет
requestedBackend	ComputeBackendKind | null	нет

Ответ при успехе · evaluate_power_query_web_connector_transform

Поле	Тип TypeScript	Обяз.
operation	"evaluate_power_query_web_connector_transform"	да
outcome	ContractPowerQueryTransformOutcome	да
loadPlan	PowerQueryLoadPlan	нет

Минимальный JSON-шаблон

{
  "operation": "evaluate_power_query_web_connector_transform",
  "mSource": "<string>",
  "requestedBackend": "native-desktop"
}

pq_postgres_cancel

Запрос

Поле	Тип TypeScript	Обяз.
operation	"pq_postgres_cancel"	да
descriptor	PqPostgresDialogDescriptor	нет

Ответ при успехе · pq_postgres_cancel

Поле	Тип TypeScript	Обяз.
operation	"pq_postgres_cancel"	да
acknowledged	boolean	да

Минимальный JSON-шаблон

{
  "operation": "pq_postgres_cancel",
  "requestedBackend": "native-desktop"
}

pq_postgres_list_navigation

Запрос

Поле	Тип TypeScript	Обяз.	Примечание из контракта
operation	"pq_postgres_list_navigation"	да
descriptor	PqPostgresDialogDescriptor	да
schema	string	нет	Без поля возвращаются корневые схемы; с полем — таблицы и представления указанной схемы.
connectUser	string	нет
lanGrants	PqPostgresLanGrantWire[]	нет
privacy	PqPrivacyEvaluationInput	нет

Ответ при успехе · pq_postgres_list_navigation

Поле	Тип TypeScript	Обяз.	Примечание из контракта
operation	"pq_postgres_list_navigation"	да
schemas	PqPostgresNavigationSchemaWire[]	нет	Есть в ответе на запрос корневых схем.
tables	PqPostgresNavTableWire[]	нет	Есть в ответе на запрос таблиц одной схемы.
denied	PqPostgresDeniedWire	нет

Минимальный JSON-шаблон

{
  "operation": "pq_postgres_list_navigation",
  "descriptor": "<PqPostgresDialogDescriptor>",
  "requestedBackend": "native-desktop"
}

pq_postgres_preview

Запрос

Поле	Тип TypeScript	Обяз.
operation	"pq_postgres_preview"	да
descriptor	PqPostgresDialogDescriptor	да
table	PqPostgresPreviewTableRef	да
maxRows	number	нет
connectUser	string	нет
lanGrants	PqPostgresLanGrantWire[]	нет
privacy	PqPrivacyEvaluationInput	нет

Ответ при успехе · pq_postgres_preview

Поле	Тип TypeScript	Обяз.	Примечание из контракта
operation	"pq_postgres_preview"	да
columns	string[]	нет
rows	string[][]	нет	Display-projected rows (each cell a string); bounded ≤ min(maxRows, descriptor bound).
truncated	boolean	да
denied	PqPostgresDeniedWire	нет

Минимальный JSON-шаблон

{
  "operation": "pq_postgres_preview",
  "descriptor": "<PqPostgresDialogDescriptor>",
  "table": "<PqPostgresPreviewTableRef>",
  "requestedBackend": "native-desktop"
}

pq_postgres_test_connection

Запрос

Поле	Тип TypeScript	Обяз.
operation	"pq_postgres_test_connection"	да
descriptor	PqPostgresDialogDescriptor	да
connectUser	string	нет
lanGrants	PqPostgresLanGrantWire[]	нет
privacy	PqPrivacyEvaluationInput	нет

Ответ при успехе · pq_postgres_test_connection

Поле	Тип TypeScript	Обяз.
operation	"pq_postgres_test_connection"	да
serverVersion	string	нет
denied	PqPostgresDeniedWire	нет

Минимальный JSON-шаблон

{
  "operation": "pq_postgres_test_connection",
  "descriptor": "<PqPostgresDialogDescriptor>",
  "requestedBackend": "native-desktop"
}

pq_sqlserver_cancel

Запрос

Поле	Тип TypeScript	Обяз.
operation	"pq_sqlserver_cancel"	да

Ответ при успехе · pq_sqlserver_cancel

Поле	Тип TypeScript	Обяз.
operation	"pq_sqlserver_cancel"	да
acknowledged	boolean	да

Минимальный JSON-шаблон

{
  "operation": "pq_sqlserver_cancel",
  "requestedBackend": "native-desktop"
}

pq_sqlserver_list_navigation

Запрос

Поле	Тип TypeScript	Обяз.
operation	"pq_sqlserver_list_navigation"	да
descriptor	PqSqlServerDescriptor	да
privacy	PqPrivacyEvaluationInput	нет

Ответ при успехе · pq_sqlserver_list_navigation

Поле	Тип TypeScript	Обяз.
operation	"pq_sqlserver_list_navigation"	да
items	PqSqlServerNavigationItemWire[]	нет
denied	PqSqlServerDeniedWire	нет

Минимальный JSON-шаблон

{
  "operation": "pq_sqlserver_list_navigation",
  "descriptor": "<PqSqlServerDescriptor>",
  "requestedBackend": "native-desktop"
}

pq_sqlserver_preview

Запрос

Поле	Тип TypeScript	Обяз.
operation	"pq_sqlserver_preview"	да
descriptor	PqSqlServerDescriptor	да
table	PqSqlServerTableRef	да
maxRows	number	нет
privacy	PqPrivacyEvaluationInput	нет

Ответ при успехе · pq_sqlserver_preview

Поле	Тип TypeScript	Обяз.
operation	"pq_sqlserver_preview"	да
columns	string[]	нет
rows	string[][]	нет
truncated	boolean	да
denied	PqSqlServerDeniedWire	нет

Минимальный JSON-шаблон

{
  "operation": "pq_sqlserver_preview",
  "descriptor": "<PqSqlServerDescriptor>",
  "table": "<PqSqlServerTableRef>",
  "requestedBackend": "native-desktop"
}

pq_sqlserver_test_connection

Запрос

Поле	Тип TypeScript	Обяз.
operation	"pq_sqlserver_test_connection"	да
descriptor	PqSqlServerDescriptor	да
privacy	PqPrivacyEvaluationInput	нет

Ответ при успехе · pq_sqlserver_test_connection

Поле	Тип TypeScript	Обяз.
operation	"pq_sqlserver_test_connection"	да
serverVersion	string	нет
denied	PqSqlServerDeniedWire	нет

Минимальный JSON-шаблон

{
  "operation": "pq_sqlserver_test_connection",
  "descriptor": "<PqSqlServerDescriptor>",
  "requestedBackend": "native-desktop"
}