SqlClient
Attributes
TRIGGER_OPERATIONS
module-attribute
TRIGGER_OPERATIONS: Dict[str, Dict[str, Any]] = {'GetOnNewItems_V2': {'operation_id': 'GetOnNewItems_V2', 'path': '/{connectionId}/v2/datasets/{server},{database}/tables/{table}/onnewitems', 'method': 'get', 'required_parameters': ['server', 'database', 'table'], 'callback_payload_type': 'SqlItemsList'}, 'GetOnUpdatedItems_V2': {'operation_id': 'GetOnUpdatedItems_V2', 'path': '/{connectionId}/datasets/{server},{database}/tables/{table}/onupdateditems', 'method': 'get', 'required_parameters': ['server', 'database', 'table'], 'callback_payload_type': 'SqlItemsList'}}
Classes
ExecutePassThroughNativeQueryResponse
dataclass
ExecuteProcedureInput
dataclass
ExecuteProcedureResponse
dataclass
GetItemResponse
dataclass
GetItemsResponse
dataclass
GetItemsResponse(metadata: Optional[List[DataWithSensitivityLabelInfo]] = None, value: Optional[List[SqlItem]] = None)
Response for Get rows
SqlItemsList
dataclass
GetTablesResponse
dataclass
GetTablesResponse(metadata: Optional[List[DataWithSensitivityLabelInfo]] = None, value: Optional[List[Table]] = None)
Response for Get tables
PatchItemInput
dataclass
PatchItemResponse
dataclass
PostItemInput
dataclass
PostItemResponse
dataclass
ODataServersList
dataclass
DatabasesList
dataclass
TablesList
dataclass
PassThroughNativeQueryMetadata
dataclass
ProceduresList
dataclass
ProcedureMetadata
dataclass
TableMetadata
dataclass
TableMetadata(name: Optional[str] = None, title: Optional[str] = None, x_ms_permission: Optional[str] = None, x_ms_capabilities: Optional[TableCapabilitiesMetadata] = None, schema: Optional[ObjectEntity] = None, referenced_entities: Optional[ObjectEntity] = None, web_url: Optional[str] = None)
Response for Get metadata of a table
Attributes
x_ms_permission
class-attribute
instance-attribute
Table permission
BlobDataSetsMetadata
dataclass
BlobDataSetsMetadata(source: Optional[str] = None, display_name: Optional[str] = None, url_encoding: Optional[str] = None)
Definition: BlobDataSetsMetadata
Attributes
display_name
class-attribute
instance-attribute
Blob dataset display name
Database
dataclass
Database(name: Optional[str] = None, display_name: Optional[str] = None, dynamic_properties: Optional[Dict[str, Any]] = None, tables: Optional[List[Table]] = None)
Definition: Database
Attributes
name
class-attribute
instance-attribute
The name of the database. The name is used at runtime.
display_name
class-attribute
instance-attribute
The display name of the database.
DataSet
dataclass
DataSet(name: Optional[str] = None, display_name: Optional[str] = None, query: Optional[List[PassThroughNativeQuery]] = None)
Definition: DataSet
Attributes
name
class-attribute
instance-attribute
Dataset name
display_name
class-attribute
instance-attribute
Dataset display name
DataSetParameter
dataclass
DataSetParameter(name: Optional[str] = None, type_: Optional[str] = None, url_encoding: Optional[str] = None, description: Optional[str] = None, required: Optional[bool] = None, x_ms_summary: Optional[str] = None, x_ms_dynamic_values: Optional[DynamicValues] = None, x_ms_dynamic_tree: Optional[DynamicTree] = None)
Definition: DataSetParameter
Attributes
type_
class-attribute
instance-attribute
Type
url_encoding
class-attribute
instance-attribute
Parameter url encoding
DataSetsList
dataclass
DataSetsMetadata
dataclass
DataSetsMetadata(tabular: Optional[TabularDataSetsMetadata] = None, blob: Optional[BlobDataSetsMetadata] = None, dataset_format: Optional[str] = None, parameters: Optional[List[DataSetParameter]] = None, no_natural_key_column_connector: Optional[NoNaturalKeyColumnConnectorMetadata] = None)
Definition: DataSetsMetadata
DataWithSensitivityLabelInfo
dataclass
DataWithSensitivityLabelInfo(name: Optional[str] = None, sensitivity_label_info: Optional[List[SensitivityLabelMetadata]] = None)
Definition: DataWithSensitivityLabelInfo
Attributes
DynamicTree
dataclass
DynamicTree(settings: Optional[DynamicTreeSettings] = None, open: Optional[DynamicTreeOpenBrowse] = None, browse: Optional[DynamicTreeOpenBrowse] = None)
Definition: DynamicTree
DynamicTreeOpenBrowse
dataclass
DynamicTreeOpenBrowse(path: Optional[str] = None, item_value_path: Optional[str] = None, item_title_path: Optional[str] = None, item_full_title_path: Optional[str] = None, item_is_parent: Optional[str] = None, selectable_filter: Optional[str] = None)
Definition: DynamicTreeOpenBrowse
Attributes
item_value_path
class-attribute
instance-attribute
Item value path
item_title_path
class-attribute
instance-attribute
Item title path
item_full_title_path
class-attribute
instance-attribute
item_full_title_path: Optional[str] = field(default=None, metadata={'wire_name': 'itemFullTitlePath'})
Item full title path
item_is_parent
class-attribute
instance-attribute
Is item parent
DynamicTreeSettings
dataclass
DynamicTreeSettings(can_select_parent_nodes: Optional[bool] = None, can_select_leaf_nodes: Optional[bool] = None, selected_item_placeholder: Optional[str] = None)
Definition: DynamicTreeSettings
Attributes
can_select_parent_nodes
class-attribute
instance-attribute
can_select_parent_nodes: Optional[bool] = field(default=None, metadata={'wire_name': 'canSelectParentNodes'})
Can select parent nodes
DynamicValues
dataclass
DynamicValues(path: Optional[str] = None, value_collection: Optional[str] = None, value_path: Optional[str] = None, value_title: Optional[str] = None)
Definition: DynamicValues
Attributes
value_collection
class-attribute
instance-attribute
Value collection
value_path
class-attribute
instance-attribute
Value path
ItemsList
dataclass
NoNaturalKeyColumnConnectorMetadata
dataclass
NoNaturalKeyColumnConnectorMetadata(create_key_column_path: Optional[str] = None, create_key_column_method: Optional[str] = None, key_column_name_url_encoding: Optional[str] = None)
Definition: NoNaturalKeyColumnConnectorMetadata
Attributes
create_key_column_path
class-attribute
instance-attribute
create_key_column_path: Optional[str] = field(default=None, metadata={'wire_name': 'createKeyColumnPath'})
Path to create key column
ObjectEntity
dataclass
PassThroughNativeQuery
dataclass
PassThroughNativeQueryBody
dataclass
PassThroughNativeQueryBody(query: Optional[str] = None, formal_parameters: Optional[Dict[str, Any]] = None, actual_parameters: Optional[Dict[str, Any]] = None)
PassThroughNativeQueryResult
dataclass
PassThroughNativeQueryResult(output_parameters: Optional[Dict[str, Any]] = None, result_sets: Optional[Dict[str, Any]] = None)
Procedure
dataclass
Definition: Procedure
ProcedureResult
dataclass
ProcedureResult(output_parameters: Optional[Dict[str, Any]] = None, return_code: Optional[int] = None, result_sets: Optional[Dict[str, Any]] = None)
Definition: ProcedureResult
Attributes
output_parameters
class-attribute
instance-attribute
output_parameters: Optional[Dict[str, Any]] = field(default=None, metadata={'wire_name': 'OutputParameters'})
Output parameter values. The schema is dynamic based on the procedure.
return_code
class-attribute
instance-attribute
Return code of a procedure.
SensitivityLabelMetadata
dataclass
SensitivityLabelMetadata(sensitivity_label_id: Optional[str] = None, name: Optional[str] = None, display_name: Optional[str] = None, tooltip: Optional[str] = None, priority: Optional[int] = None, color: Optional[str] = None, is_encrypted: Optional[bool] = None, is_enabled: Optional[bool] = None, is_parent: Optional[bool] = None, parent_sensitivity_label_id: Optional[str] = None)
Definition: SensitivityLabelMetadata
Attributes
sensitivity_label_id
class-attribute
instance-attribute
sensitivity_label_id: Optional[str] = field(default=None, metadata={'wire_name': 'sensitivityLabelId'})
SensitivityLabel Id.
display_name
class-attribute
instance-attribute
SensitivityLabel displayName info
tooltip
class-attribute
instance-attribute
SensitivityLabel details on tooltip.
priority
class-attribute
instance-attribute
SensitivityLabel priority.
is_encrypted
class-attribute
instance-attribute
is SensitivityLabel Encrypted.
is_enabled
class-attribute
instance-attribute
Whether SensitivityLabel is Enabled.
is_parent
class-attribute
instance-attribute
Whether SensitivityLabel is Parent.
Server
dataclass
Server(name: Optional[str] = None, display_name: Optional[str] = None, dynamic_properties: Optional[Dict[str, Any]] = None, databases: Optional[List[Database]] = None)
Definition: Server
Attributes
name
class-attribute
instance-attribute
The name of the server. The name is used at runtime.
display_name
class-attribute
instance-attribute
The display name of the server.
SqlPassThroughNativeQueryBody
dataclass
SqlPassThroughNativeQueryBody(actual_parameters: Optional[Dict[str, Any]] = None, query: Optional[str] = None, formal_parameters: Optional[Dict[str, Any]] = None)
SqlPassThroughNativeQueryResult
dataclass
SqlPassThroughNativeQueryResult(output_parameters: Optional[Dict[str, Any]] = None, result_sets: Optional[Dict[str, Any]] = None)
Table
dataclass
Table(name: Optional[str] = None, display_name: Optional[str] = None, dynamic_properties: Optional[Dict[str, Any]] = None)
Definition: Table
Attributes
name
class-attribute
instance-attribute
The name of the table. The name is used at runtime.
display_name
class-attribute
instance-attribute
The display name of the table.
TableCapabilitiesMetadata
dataclass
TableCapabilitiesMetadata(sort_restrictions: Optional[TableSortRestrictionsMetadata] = None, filter_restrictions: Optional[TableFilterRestrictionsMetadata] = None, select_restrictions: Optional[TableSelectRestrictionsMetadata] = None, count_restrictions: Optional[TableCountRestrictionsMetadata] = None, is_only_server_pagable: Optional[bool] = None, filter_function_support: Optional[List[str]] = None, server_paging_options: Optional[List[str]] = None)
Definition: TableCapabilitiesMetadata
Attributes
is_only_server_pagable
class-attribute
instance-attribute
is_only_server_pagable: Optional[bool] = field(default=None, metadata={'wire_name': 'isOnlyServerPagable'})
Server paging restrictions
TableFilterRestrictionsMetadata
dataclass
TableFilterRestrictionsMetadata(filterable: Optional[bool] = None, non_filterable_properties: Optional[List[str]] = None, required_properties: Optional[List[str]] = None)
Definition: TableFilterRestrictionsMetadata
Attributes
filterable
class-attribute
instance-attribute
Indicates whether this table has filterable columns
TableSelectRestrictionsMetadata
dataclass
TableCountRestrictionsMetadata
dataclass
TableSortRestrictionsMetadata
dataclass
TableSortRestrictionsMetadata(sortable: Optional[bool] = None, unsortable_properties: Optional[List[str]] = None, ascending_only_properties: Optional[List[str]] = None)
Definition: TableSortRestrictionsMetadata
Attributes
sortable
class-attribute
instance-attribute
Indicates whether this table has sortable columns
TabularDataSetsMetadata
dataclass
TabularDataSetsMetadata(source: Optional[str] = None, display_name: Optional[str] = None, url_encoding: Optional[str] = None, table_display_name: Optional[str] = None, table_plural_name: Optional[str] = None)
Definition: TabularDataSetsMetadata
Attributes
display_name
class-attribute
instance-attribute
Dataset display name
url_encoding
class-attribute
instance-attribute
Dataset url encoding
table_display_name
class-attribute
instance-attribute
Table display name
PassThroughPQBody
dataclass
PQMetadata
dataclass
PQMetadataValue
dataclass
PassThroughPQResult
dataclass
Definition: PassThroughPQResult
PQRows
dataclass
SqlClient
SqlClient(connection_runtime_url: str, token_provider: Optional[TokenProvider] = None, options: Optional[ConnectorClientOptions] = None)
Bases: ConnectorClientBase
Typed client for sql connector.
Initialize a SqlClient.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
connection_runtime_url
|
str
|
The connection runtime URL from Azure Portal. |
required |
token_provider
|
Optional[TokenProvider]
|
Optional token provider. Defaults to ManagedIdentityTokenProvider. |
None
|
options
|
Optional[ConnectorClientOptions]
|
Optional connector client options. |
None
|
Methods:
delete_item_async
async
Delete row
This operation deletes a row from a table.
execute_pass_through_native_query_async
async
execute_pass_through_native_query_async(input: SqlPassThroughNativeQueryBody, server: str, database: str) -> dict[str, Any] | None
Execute a SQL query
Execute a SQL query
execute_procedure_async
async
execute_procedure_async(input: ExecuteProcedureInput, server: str, database: str, procedure: str) -> dict[str, Any] | None
Execute stored procedure
This operation runs a stored procedure.
get_item_async
async
Get row
This operation gets a row from a table.
get_items_async
async
get_items_async(server: str, database: str, table: str, apply: Optional[str] = None, filter: Optional[str] = None, orderby: Optional[str] = None, skip: Optional[int] = None, top: Optional[int] = None, select: Optional[str] = None, count: Optional[bool] = None, extract_sensitivity_label: Optional[bool] = None, purview_account_name: Optional[str] = None) -> dict[str, Any] | None
Get rows
This operation gets rows from a table.
get_tables_async
async
get_tables_async(server: str, database: str, extract_sensitivity_label: Optional[bool] = None, purview_account_name: Optional[str] = None) -> dict[str, Any] | None
Get tables
This operation gets tables from a database.
patch_item_async
async
patch_item_async(input: PatchItemInput, server: str, database: str, table: str, id: str) -> dict[str, Any] | None
Update row
This operation updates an existing row in a table.
post_item_async
async
post_item_async(input: PostItemInput, server: str, database: str, table: str) -> dict[str, Any] | None
Insert row
This operation inserts a new row into a table.
get_servers_async
async
List the servers
List the servers
get_databases_async
async
List the databases
List the databases
get_tables_for_delete_item_async
async
GetTablesForDeleteItem
GetTablesForDeleteItem
get_pass_through_native_query_metadata_async
async
get_pass_through_native_query_metadata_async(input: SqlPassThroughNativeQueryBody, server: str, database: str) -> dict[str, Any] | None
Get pass-through native SQL query metadata
Retrieves metadata for a pass-through native SQL query.
get_procedures_v2_async
async
Get stored procedures
This operation gets stored procedures for a database.
get_procedure_v2_async
async
Get metadata of a Procedure
Get metadata of a Procedure.
get_tables_for_get_item_async
async
GetTablesForGetItem
GetTablesForGetItem
get_table_async
async
get_table_async(server: str, database: str, table: str, extract_sensitivity_label: Optional[bool] = None, purview_account_name: Optional[str] = None) -> dict[str, Any] | None
Get metadata of a table
Get metadata of a table.
get_tables_for_get_on_new_items_async
async
GetTablesForOnItemCreated
GetTablesForOnItemCreated
get_tables_for_get_on_updated_items_async
async
GetTablesForOnItemUpdated
GetTablesForOnItemUpdated
get_tables_for_patch_item_async
async
GetTablesForPatchItem
GetTablesForPatchItem
get_table_for_patch_async
async
Get metadata of a table for Patch operation
Get metadata of a table for Patch operation.
get_tables_for_post_item_async
async
GetTablesForPostItem
GetTablesForPostItem
get_procedure_async
async
Get procedure metadata
This operation gets metadata for a stored procedure.