Table: azure_data_protection_backup_job - Query Azure Data Protection Backup Jobs using SQL
Azure Data Protection Backup Jobs enable organizations to manage and monitor the backup processes for various data sources. These jobs provide detailed information about the backup instances, job statuses, errors, and performance metrics, which are essential for ensuring data integrity and recovery.
Table Usage Guide
The azure_data_protection_backup_job
table provides insights into backup jobs within Microsoft Azure. As an IT Administrator or Data Protection Officer, you can explore details about each backup job, including its status, duration, errors, and associated resources. Use this table to ensure your backup processes are functioning correctly and to quickly identify and resolve any issues.
Examples
Basic info
Explore the status and details of your Azure Data Protection Backup Jobs to understand their current state and type. This is beneficial for auditing and managing your backup processes effectively.
select name, id, operation, operation_category, status, start_time, end_timefrom azure_data_protection_backup_job;
select name, id, operation, operation_category, status, start_time, end_timefrom azure_data_protection_backup_job;
List backup jobs with errors
Identify backup jobs that have encountered errors. This helps in troubleshooting and resolving issues to ensure data protection continuity.
select name, id, status, jsonb_array_elements_text(error_details) as error_detailfrom azure_data_protection_backup_jobwhere status = 'Failed';
select name, id, status, json_each_text(error_details) as error_detailfrom azure_data_protection_backup_jobwhere status = 'Failed';
List user-triggered backup jobs
Explore the backup jobs that were triggered manually by users. This helps in understanding the frequency and context of adhoc backups.
select name, id, is_user_triggered, start_time, end_timefrom azure_data_protection_backup_jobwhere is_user_triggered = true;
select name, id, is_user_triggered, start_time, end_timefrom azure_data_protection_backup_jobwhere is_user_triggered = true;
List backup jobs by policy
Get an overview of backup jobs associated with specific policies. This can assist in ensuring compliance with data protection policies and understanding the effectiveness of different backup strategies.
select name, id, policy_name, start_time, end_time, statusfrom azure_data_protection_backup_jobwhere policy_name = 'your_policy_name';
select name, id, policy_name, start_time, end_time, statusfrom azure_data_protection_backup_jobwhere policy_name = 'your_policy_name';
List backup jobs by data source
Explore backup jobs based on their data sources. This helps in understanding the backup coverage and identifying any gaps in data protection.
select name, id, data_source_name, data_source_type, start_time, end_time, statusfrom azure_data_protection_backup_jobwhere data_source_name = 'your_data_source_name';
select name, id, data_source_name, data_source_type, start_time, end_time, statusfrom azure_data_protection_backup_jobwhere data_source_name = 'your_data_source_name';
List backup jobs by region
Get a regional overview of your backup jobs to ensure that all geographical locations are adequately covered and to identify any regional issues.
select name, id, region, start_time, end_time, statusfrom azure_data_protection_backup_jobwhere region = 'your_region';
select name, id, region, start_time, end_time, statusfrom azure_data_protection_backup_jobwhere region = 'your_region';
List backup jobs with long duration
Identify backup jobs that have taken longer than expected to complete. This helps in identifying performance bottlenecks and optimizing backup processes.
select name, id, duration, start_time, end_time, statusfrom azure_data_protection_backup_jobwhere duration > 'PT1H';-- Jobs longer than 1 hour
select name, id, duration, start_time, end_time, statusfrom azure_data_protection_backup_jobwhere duration > 'PT1H';-- Jobs longer than 1 hour
List backup jobs by status
Explore backup jobs based on their status to monitor ongoing and completed jobs, and to identify any jobs that may require attention.
select name, id, status, start_time, end_timefrom azure_data_protection_backup_jobwhere status = 'InProgress';
select name, id, status, start_time, end_timefrom azure_data_protection_backup_jobwhere status = 'InProgress';
Schema for azure_data_protection_backup_job
Name | Type | Operators | Description |
---|---|---|---|
_ctx | jsonb | Steampipe context in JSON form. | |
activity_id | text | Job Activity Id. | |
akas | jsonb | Array of globally unique identifier strings (also known as) for the resource. | |
backup_instance_friendly_name | text | Name of the Backup Instance. | |
backup_instance_id | text | ARM ID of the Backup Instance. | |
cloud_environment | text | The Azure Cloud Environment. | |
data_source_id | text | ARM ID of the DataSource. | |
data_source_location | text | Location of the DataSource. | |
data_source_name | text | User Friendly Name of the DataSource. | |
data_source_set_name | text | Data Source Set Name of the DataSource. | |
data_source_type | text | Type of DataSource. | |
destination_data_store_name | text | Destination Data Store Name. | |
duration | text | Total run time of the job. ISO 8601 format. | |
end_time | timestamp with time zone | EndTime of the job (in UTC). | |
error_details | jsonb | A List, detailing the errors related to the job. | |
etag | text | An unique read-only string that changes whenever the resource is updated. | |
extended_info | jsonb | Extended Information about the job. | |
id | text | Resource ID represents the complete path to the resource. | |
is_user_triggered | boolean | Indicates whether the job is adhoc(true) or scheduled(false). | |
name | text | Resource name associated with the resource. | |
operation | text | Type of Job i.e. Backup:full/log/diff ;Restore:ALR/OLR; Tiering:Backup/Archive ; Management:ConfigureProtection/UnConfigure. | |
operation_category | text | Indicates the type of Job i.e. Backup/Restore/Tiering/Management. | |
policy_id | text | ARM ID of the policy. | |
policy_name | text | Name of the policy. | |
progress_enabled | boolean | Indicates whether progress is enabled for the job. | |
progress_url | text | Url which contains job's progress. | |
region | text | The Azure region/location in which the resource is located. | |
resource_group | text | = | The resource group which holds this resource. |
restore_type | text | Indicates the sub type of operation i.e. in case of Restore it can be ALR/OLR. | |
source_data_store_name | text | Source Data Store Name. | |
source_resource_group | text | Resource Group Name of the Datasource. | |
source_subscription_id | text | SubscriptionId corresponding to the DataSource. | |
sp_connection_name | text | =, !=, ~~, ~~*, !~~, !~~* | Steampipe connection name. |
sp_ctx | jsonb | Steampipe context in JSON form. | |
start_time | timestamp with time zone | StartTime of the job (in UTC). | |
status | text | Status of the job like InProgress/Success/Failed/Cancelled/SuccessWithWarning. | |
subscription_id | text | =, !=, ~~, ~~*, !~~, !~~* | The Azure Subscription ID in which the resource is located. |
supported_actions | jsonb | List of supported actions. | |
title | text | Title of the resource. | |
type | text | Resource type represents the complete path of the form Namespace/ResourceType/ResourceType/... | |
vault_name | text | = | The data protection vault name. |
Export
This table is available as a standalone Exporter CLI. Steampipe exporters are stand-alone binaries that allow you to extract data using Steampipe plugins without a database.
You can download the tarball for your platform from the Releases page, but it is simplest to install them with the steampipe_export_installer.sh
script:
/bin/sh -c "$(curl -fsSL https://steampipe.io/install/export.sh)" -- azure
You can pass the configuration to the command with the --config
argument:
steampipe_export_azure --config '<your_config>' azure_data_protection_backup_job