Skip to main content

managed_database_queries

Creates, updates, deletes, gets or lists a managed_database_queries resource.

Overview

Namemanaged_database_queries
TypeResource
Idazure.sql.managed_database_queries

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
idstringFully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}.
namestringThe name of the resource.
queryTextstringQuery text.
systemDataobjectAzure Resource Manager metadata containing createdBy and modifiedBy information.
typestringThe type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts".

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getselectresource_group_name, managed_instance_name, database_name, query_id, subscription_idGet query by query id.
list_by_queryexecresource_group_name, managed_instance_name, database_name, query_id, subscription_idstartTime, endTime, intervalGet query execution statistics by query id.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
database_namestringThe name of the database. Required.
managed_instance_namestringThe name of the managed instance. Required.
query_idstringRequired.
resource_group_namestringThe name of the resource group. The name is case insensitive. Required.
subscription_idstring
endTimestringEnd time for observed period. Default value is None.
intervalstringThe time step to be used to summarize the metric values. Known values are: "PT1H" and "P1D". Default value is None.
startTimestringStart time for observed period. Default value is None.

SELECT examples

Get query by query id.

SELECT
id,
name,
queryText,
systemData,
type
FROM azure.sql.managed_database_queries
WHERE resource_group_name = '{{ resource_group_name }}' -- required
AND managed_instance_name = '{{ managed_instance_name }}' -- required
AND database_name = '{{ database_name }}' -- required
AND query_id = '{{ query_id }}' -- required
AND subscription_id = '{{ subscription_id }}' -- required
;

Lifecycle Methods

Get query execution statistics by query id.

EXEC azure.sql.managed_database_queries.list_by_query 
@resource_group_name='{{ resource_group_name }}' --required,
@managed_instance_name='{{ managed_instance_name }}' --required,
@database_name='{{ database_name }}' --required,
@query_id='{{ query_id }}' --required,
@subscription_id='{{ subscription_id }}' --required,
@startTime='{{ startTime }}',
@endTime='{{ endTime }}',
@interval='{{ interval }}'
;