Power Query и внешние источники · часть 3

Вычисление и инспекция M-выражений, коннекторы OData, Postgres, SQL Server и Web, шаги запроса, навигация, параметры и уровни приватности. Операций на странице: 17.

Домен разбит на несколько страниц: часть 1 · часть 2 · часть 3.

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

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
product_table_range_load_to
product_table_range_mutate_step
product_table_range_open_query
product_table_range_refresh_all
product_table_range_refresh_current
profile_applied_step_columns
project_applied_steps
save_power_query_definition
source_trust_decision

pq_postgres_cancel

Операция pq postgres cancel.

Request

Поле	Тип TypeScript	Обяз.	Примечание из контракта
operation	“pq_postgres_cancel”	да
descriptor	PqPostgresDialogDescriptor	нет

Success payload · pq_postgres_cancel

Поле	Тип TypeScript	Обяз.	Примечание из контракта
operation	“pq_postgres_cancel”	да
acknowledged	boolean	да

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

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

pq_postgres_list_navigation

Операция pq postgres list navigation.

Request

Поле	Тип TypeScript	Обяз.	Примечание из контракта
operation	“pq_postgres_list_navigation”	да
descriptor	PqPostgresDialogDescriptor	да
schema	string	нет	Absent ⇒ schema roots; present ⇒ that schema’s tables/views.
connectUser	string	нет
lanGrants	PqPostgresLanGrantWire[]	нет
privacy	PqPrivacyEvaluationInput	нет

Success payload · pq_postgres_list_navigation

Поле	Тип TypeScript	Обяз.	Примечание из контракта
operation	“pq_postgres_list_navigation”	да
schemas	PqPostgresNavigationSchemaWire[]	нет	Present for a schema-roots request.
tables	PqPostgresNavTableWire[]	нет	Present for a single-schema tables request.
denied	PqPostgresDeniedWire	нет

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

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

pq_postgres_preview

Операция pq postgres preview.

Request

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

Success payload · 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

Операция pq postgres test connection.

Request

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

Success payload · 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

Операция pq sqlserver cancel.

Request

Поле	Тип TypeScript	Обяз.	Примечание из контракта
operation	“pq_sqlserver_cancel”	да

Success payload · pq_sqlserver_cancel

Поле	Тип TypeScript	Обяз.	Примечание из контракта
operation	“pq_sqlserver_cancel”	да
acknowledged	boolean	да

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

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

pq_sqlserver_list_navigation

Операция pq sqlserver list navigation.

Request

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

Success payload · 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

Операция pq sqlserver preview.

Request

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

Success payload · 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

Операция pq sqlserver test connection.

Request

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

Success payload · 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"
}

product_table_range_load_to

Операция product table range load to.

Request

Поле	Тип TypeScript	Обяз.
operation	“product_table_range_load_to”	да
subsetId	string	да
identity	TableRangeSourceIdentity	да
mText	string	да
queryStableId	string	нет
displayName	string	нет
destination	TableRangeOutputPlacement	да
anchor	CellAnchor	нет
includeHeader	boolean	да
requestedBackend	ComputeBackendKind \| null	нет

Success payload · product_table_range_load_to

Поле	Тип TypeScript	Обяз.	Примечание из контракта
operation	“product_table_range_load_to”	да

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

{
  "operation": "product_table_range_load_to",
  "subsetId": "<subsetId>",
  "identity": "<TableRangeSourceIdentity>",
  "mText": "<string>",
  "destination": "<TableRangeOutputPlacement>",
  "includeHeader": false,
  "requestedBackend": "native-desktop"
}

product_table_range_mutate_step

Операция product table range mutate step.

Request

Поле	Тип TypeScript	Обяз.
operation	“product_table_range_mutate_step”	да
subsetId	string	да
identity	TableRangeSourceIdentity	да
mText	string	да
queryStableId	string	нет
mutation	StepMutation	да
editorSessionId	string	нет
generation	number	нет
requestedBackend	ComputeBackendKind \| null	нет

Success payload · product_table_range_mutate_step

Поле	Тип TypeScript	Обяз.
operation	“product_table_range_mutate_step”	да
result	TableRangeQueryMutationPreview	да
session	EditorSessionStamp	нет

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

{
  "operation": "product_table_range_mutate_step",
  "subsetId": "<subsetId>",
  "identity": "<TableRangeSourceIdentity>",
  "mText": "<string>",
  "mutation": "<StepMutation>",
  "requestedBackend": "native-desktop"
}

product_table_range_open_query

Операция product table range open query.

Request

Поле	Тип TypeScript	Обяз.
operation	“product_table_range_open_query”	да
subsetId	string	да
identity	TableRangeSourceIdentity	да
queryStableId	string	нет
requestedBackend	ComputeBackendKind \| null	нет

Success payload · product_table_range_open_query

Поле	Тип TypeScript	Обяз.
operation	“product_table_range_open_query”	да
ready	boolean	да
projection	AppliedStepsProjection	нет
preview	TableRangeQueryPreview	нет
session	EditorSessionStamp	нет
blockReason	string	нет
blockDetail	string	нет
existingOutputStableId	string	нет

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

{
  "operation": "product_table_range_open_query",
  "subsetId": "<subsetId>",
  "identity": "<TableRangeSourceIdentity>",
  "requestedBackend": "native-desktop"
}

product_table_range_refresh_all

Операция product table range refresh all.

Request

Поле	Тип TypeScript	Обяз.
operation	“product_table_range_refresh_all”	да
subsetId	string	да
action	“run” \| “start” \| “poll” \| “commit” \| “cancel”	нет
generation	number	нет
requestedBackend	ComputeBackendKind \| null	нет

Success payload · product_table_range_refresh_all

Поле	Тип TypeScript	Обяз.	Примечание из контракта
operation	“product_table_range_refresh_all”	да

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

{
  "operation": "product_table_range_refresh_all",
  "subsetId": "<subsetId>",
  "requestedBackend": "native-desktop"
}

product_table_range_refresh_current

Операция product table range refresh current.

Request

Поле	Тип TypeScript	Обяз.
operation	“product_table_range_refresh_current”	да
subsetId	string	да
queryStableId	string	да
action	“run” \| “start” \| “poll” \| “commit” \| “cancel”	нет
generation	number	нет
requestedBackend	ComputeBackendKind \| null	нет

Success payload · product_table_range_refresh_current

Поле	Тип TypeScript	Обяз.	Примечание из контракта
operation	“product_table_range_refresh_current”	да

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

{
  "operation": "product_table_range_refresh_current",
  "subsetId": "<subsetId>",
  "queryStableId": "<string>",
  "requestedBackend": "native-desktop"
}

profile_applied_step_columns

Профилирует applied step columns.

Request

Поле	Тип TypeScript	Обяз.	Примечание из контракта
operation	“profile_applied_step_columns”	да
mText	string	да
queryStableId	string	нет
stepId	string	нет
editorSessionId	string	нет	PQ-EDITOR-003 seam A (additive, OPTIONAL): editor session tag — see project_applied_steps.
generation	number	нет
requestedBackend	ComputeBackendKind \| null	нет

Success payload · profile_applied_step_columns

Поле	Тип TypeScript	Обяз.	Примечание из контракта
operation	“profile_applied_step_columns”	да
profiled	boolean	да	true when a profile was computed; false when the underlying evaluation blocked.
columns	ColumnProfile[]	да	One profile per result column (empty when blocked). Rust-owned facts; the UI renders them.
rowCount	number	да	The result’s TRUE row count (not the sample size).
sampled	boolean	да	true when the profile covers only a bounded leading subset (rowCount > sampleCap).
sampledRows	number	да	The number of rows actually profiled (min(rowCount, sampleCap)) — the field the live shell transport reads.
sampleCap	number	да	The frozen row-sample cap in effect for this pass.
block	{ sourceId: string; mSource: string; reason: string; detail: string; }	нет	The structural block when profiling was refused (no partial profile); absent when profiled.
session	EditorSessionStamp	нет	The session stamp echoed on a session-bound response (absent on the session-less path).

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

{
  "operation": "profile_applied_step_columns",
  "mText": "<string>",
  "requestedBackend": "native-desktop"
}

project_applied_steps

Проецирует applied steps.

Request

Поле	Тип TypeScript	Обяз.	Примечание из контракта
operation	“project_applied_steps”	да
mText	string	да
queryStableId	string	нет
editorSessionId	string	нет	PQ-EDITOR-003 seam A (additive, OPTIONAL): the Rust-minted editor session tag. Absent = the byte-compatible stateless path (behaves exactly as today); present = seams B/E validate it (gate_editor_request) before acting, refusing a stale/closed/foreign session typed.
generation	number	нет
requestedBackend	ComputeBackendKind \| null	нет

Success payload · project_applied_steps

Поле	Тип TypeScript	Обяз.	Примечание из контракта
operation	“project_applied_steps”	да
projection	AppliedStepsProjection	да

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

{
  "operation": "project_applied_steps",
  "mText": "<string>",
  "requestedBackend": "native-desktop"
}

save_power_query_definition

Сохраняет power query definition.

Request

Поле	Тип TypeScript	Обяз.
operation	“save_power_query_definition”	да
subsetId	string	да
query	unknown	да
boundDestinationSheetKey	string	нет
requestedBackend	ComputeBackendKind \| null	нет

Success payload · save_power_query_definition

Поле	Тип TypeScript	Обяз.
operation	“save_power_query_definition”	да
status	string	да
reason	string	нет

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

{
  "operation": "save_power_query_definition",
  "subsetId": "<subsetId>",
  "query": "<unknown>",
  "requestedBackend": "native-desktop"
}

source_trust_decision

Операция source trust decision.

Request

Поле	Тип TypeScript	Обяз.
operation	“source_trust_decision”	да
action	ContractSourceTrustAction	да
observation	ContractSourceTrustObservation	да
grant	ContractSourceTrustGrantBinding \| null	нет
session	ContractSourceTrustSessionBinding \| null	нет
requestedBackend	ComputeBackendKind \| null	нет

Success payload · source_trust_decision

Поле	Тип TypeScript	Обяз.	Примечание из контракта
operation	“source_trust_decision”	да
decision	ContractSourceTrustDecision	да

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

{
  "operation": "source_trust_decision",
  "action": "<ContractSourceTrustAction>",
  "observation": "<ContractSourceTrustObservation>",
  "requestedBackend": "native-desktop"
}