Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .codegen/_openapi_sha
Original file line number Diff line number Diff line change
@@ -1 +1 @@
8921a828d1741af0952eb5c4f0292c194c0d5f38
e16060430295515f0c147e5252a3fee3c19fde9f
2 changes: 1 addition & 1 deletion NEXT_CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,4 +28,4 @@
* [Breaking] Remove `pgbouncerSettings` field for `com.databricks.sdk.service.postgres.EndpointSettings`.
* [Breaking] Remove `poolerMode` field for `com.databricks.sdk.service.postgres.EndpointSpec`.
* [Breaking] Remove `poolerMode` field for `com.databricks.sdk.service.postgres.EndpointStatus`.
* [Breaking] Remove `pgbouncerSettings` field for `com.databricks.sdk.service.postgres.ProjectDefaultEndpointSettings`.
* [Breaking] Remove `pgbouncerSettings` field for `com.databricks.sdk.service.postgres.ProjectDefaultEndpointSettings`.

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

43 changes: 29 additions & 14 deletions databricks-sdk-java/src/main/java/com/databricks/sdk/service/catalog/QualityMonitorsAPI.java
100755 → 100644
Original file line number Diff line number Diff line change
Expand Up @@ -7,11 +7,15 @@
import org.slf4j.LoggerFactory;

/**
* A monitor computes and monitors data or model quality metrics for a table over time. It generates
* metrics tables and a dashboard that you can use to monitor table health and set alerts. Most
* write operations require the user to be the owner of the table (or its parent schema or parent
* catalog). Viewing the dashboard, computed metrics, or monitor configuration only requires the
* user to have **SELECT** privileges on the table (along with **USE_SCHEMA** and **USE_CATALOG**).
* [DEPRECATED] This API is deprecated. Please use the Data Quality Monitors API instead (REST:
* /api/data-quality/v1/monitors), which manages both Data Profiling and Anomaly Detection.
*
* <p>A monitor computes and monitors data or model quality metrics for a table over time. It
* generates metrics tables and a dashboard that you can use to monitor table health and set alerts.
* Most write operations require the user to be the owner of the table (or its parent schema or
* parent catalog). Viewing the dashboard, computed metrics, or monitor configuration only requires
* the user to have **SELECT** privileges on the table (along with **USE_SCHEMA** and
* **USE_CATALOG**).
*/
@Generated
public class QualityMonitorsAPI {
Expand All @@ -29,13 +33,17 @@ public QualityMonitorsAPI(QualityMonitorsService mock) {
impl = mock;
}

/** Cancels an already-initiated refresh job. */
/**
* [DEPRECATED] Cancels an already-initiated refresh job. Use Data Quality Monitors API instead
* (/api/data-quality/v1/monitors).
*/
public void cancelRefresh(CancelRefreshRequest request) {
impl.cancelRefresh(request);
}

/**
* Creates a new monitor for the specified table.
* [DEPRECATED] Creates a new monitor for the specified table. Use Data Quality Monitors API
* instead (/api/data-quality/v1/monitors).
*
* <p>The caller must either: 1. be an owner of the table's parent catalog, have **USE_SCHEMA** on
* the table's parent schema, and have **SELECT** access on the table 2. have **USE_CATALOG** on
Expand All @@ -55,7 +63,8 @@ public DeleteMonitorResponse delete(String tableName) {
}

/**
* Deletes a monitor for the specified table.
* [DEPRECATED] Deletes a monitor for the specified table. Use Data Quality Monitors API instead
* (/api/data-quality/v1/monitors).
*
* <p>The caller must either: 1. be an owner of the table's parent catalog 2. have **USE_CATALOG**
* on the table's parent catalog and be an owner of the table's parent schema 3. have the
Expand All @@ -76,7 +85,8 @@ public MonitorInfo get(String tableName) {
}

/**
* Gets a monitor for the specified table.
* [DEPRECATED] Gets a monitor for the specified table. Use Data Quality Monitors API instead
* (/api/data-quality/v1/monitors).
*
* <p>The caller must either: 1. be an owner of the table's parent catalog 2. have **USE_CATALOG**
* on the table's parent catalog and be an owner of the table's parent schema. 3. have the
Expand All @@ -96,7 +106,8 @@ public MonitorRefreshInfo getRefresh(String tableName, long refreshId) {
}

/**
* Gets info about a specific monitor refresh using the given refresh ID.
* [DEPRECATED] Gets info about a specific monitor refresh using the given refresh ID. Use Data
* Quality Monitors API instead (/api/data-quality/v1/monitors).
*
* <p>The caller must either: 1. be an owner of the table's parent catalog 2. have **USE_CATALOG**
* on the table's parent catalog and be an owner of the table's parent schema 3. have the
Expand All @@ -114,7 +125,8 @@ public MonitorRefreshListResponse listRefreshes(String tableName) {
}

/**
* Gets an array containing the history of the most recent refreshes (up to 25) for this table.
* [DEPRECATED] Gets an array containing the history of the most recent refreshes (up to 25) for
* this table. Use Data Quality Monitors API instead (/api/data-quality/v1/monitors).
*
* <p>The caller must either: 1. be an owner of the table's parent catalog 2. have **USE_CATALOG**
* on the table's parent catalog and be an owner of the table's parent schema 3. have the
Expand All @@ -128,7 +140,8 @@ public MonitorRefreshListResponse listRefreshes(ListRefreshesRequest request) {
}

/**
* Regenerates the monitoring dashboard for the specified table.
* [DEPRECATED] Regenerates the monitoring dashboard for the specified table. Use Data Quality
* Monitors API instead (/api/data-quality/v1/monitors).
*
* <p>The caller must either: 1. be an owner of the table's parent catalog 2. have **USE_CATALOG**
* on the table's parent catalog and be an owner of the table's parent schema 3. have the
Expand All @@ -143,7 +156,8 @@ public RegenerateDashboardResponse regenerateDashboard(RegenerateDashboardReques
}

/**
* Queues a metric refresh on the monitor for the specified table. The refresh will execute in the
* [DEPRECATED] Queues a metric refresh on the monitor for the specified table. Use Data Quality
* Monitors API instead (/api/data-quality/v1/monitors). The refresh will execute in the
* background.
*
* <p>The caller must either: 1. be an owner of the table's parent catalog 2. have **USE_CATALOG**
Expand All @@ -158,7 +172,8 @@ public MonitorRefreshInfo runRefresh(RunRefreshRequest request) {
}

/**
* Updates a monitor for the specified table.
* [DEPRECATED] Updates a monitor for the specified table. Use Data Quality Monitors API instead
* (/api/data-quality/v1/monitors).
*
* <p>The caller must either: 1. be an owner of the table's parent catalog 2. have **USE_CATALOG**
* on the table's parent catalog and be an owner of the table's parent schema 3. have the
Expand Down
43 changes: 29 additions & 14 deletions ...cks-sdk-java/src/main/java/com/databricks/sdk/service/catalog/QualityMonitorsService.java
100755 → 100644
Original file line number Diff line number Diff line change
Expand Up @@ -4,23 +4,31 @@
import com.databricks.sdk.support.Generated;

/**
* A monitor computes and monitors data or model quality metrics for a table over time. It generates
* metrics tables and a dashboard that you can use to monitor table health and set alerts. Most
* write operations require the user to be the owner of the table (or its parent schema or parent
* catalog). Viewing the dashboard, computed metrics, or monitor configuration only requires the
* user to have **SELECT** privileges on the table (along with **USE_SCHEMA** and **USE_CATALOG**).
* [DEPRECATED] This API is deprecated. Please use the Data Quality Monitors API instead (REST:
* /api/data-quality/v1/monitors), which manages both Data Profiling and Anomaly Detection.
*
* <p>A monitor computes and monitors data or model quality metrics for a table over time. It
* generates metrics tables and a dashboard that you can use to monitor table health and set alerts.
* Most write operations require the user to be the owner of the table (or its parent schema or
* parent catalog). Viewing the dashboard, computed metrics, or monitor configuration only requires
* the user to have **SELECT** privileges on the table (along with **USE_SCHEMA** and
* **USE_CATALOG**).
*
* <p>This is the high-level interface, that contains generated methods.
*
* <p>Evolving: this interface is under development. Method signatures may change.
*/
@Generated
public interface QualityMonitorsService {
/** Cancels an already-initiated refresh job. */
/**
* [DEPRECATED] Cancels an already-initiated refresh job. Use Data Quality Monitors API instead
* (/api/data-quality/v1/monitors).
*/
void cancelRefresh(CancelRefreshRequest cancelRefreshRequest);

/**
* Creates a new monitor for the specified table.
* [DEPRECATED] Creates a new monitor for the specified table. Use Data Quality Monitors API
* instead (/api/data-quality/v1/monitors).
*
* <p>The caller must either: 1. be an owner of the table's parent catalog, have **USE_SCHEMA** on
* the table's parent schema, and have **SELECT** access on the table 2. have **USE_CATALOG** on
Expand All @@ -34,7 +42,8 @@ public interface QualityMonitorsService {
MonitorInfo create(CreateMonitor createMonitor);

/**
* Deletes a monitor for the specified table.
* [DEPRECATED] Deletes a monitor for the specified table. Use Data Quality Monitors API instead
* (/api/data-quality/v1/monitors).
*
* <p>The caller must either: 1. be an owner of the table's parent catalog 2. have **USE_CATALOG**
* on the table's parent catalog and be an owner of the table's parent schema 3. have the
Expand All @@ -49,7 +58,8 @@ public interface QualityMonitorsService {
DeleteMonitorResponse delete(DeleteQualityMonitorRequest deleteQualityMonitorRequest);

/**
* Gets a monitor for the specified table.
* [DEPRECATED] Gets a monitor for the specified table. Use Data Quality Monitors API instead
* (/api/data-quality/v1/monitors).
*
* <p>The caller must either: 1. be an owner of the table's parent catalog 2. have **USE_CATALOG**
* on the table's parent catalog and be an owner of the table's parent schema. 3. have the
Expand All @@ -63,7 +73,8 @@ public interface QualityMonitorsService {
MonitorInfo get(GetQualityMonitorRequest getQualityMonitorRequest);

/**
* Gets info about a specific monitor refresh using the given refresh ID.
* [DEPRECATED] Gets info about a specific monitor refresh using the given refresh ID. Use Data
* Quality Monitors API instead (/api/data-quality/v1/monitors).
*
* <p>The caller must either: 1. be an owner of the table's parent catalog 2. have **USE_CATALOG**
* on the table's parent catalog and be an owner of the table's parent schema 3. have the
Expand All @@ -75,7 +86,8 @@ public interface QualityMonitorsService {
MonitorRefreshInfo getRefresh(GetRefreshRequest getRefreshRequest);

/**
* Gets an array containing the history of the most recent refreshes (up to 25) for this table.
* [DEPRECATED] Gets an array containing the history of the most recent refreshes (up to 25) for
* this table. Use Data Quality Monitors API instead (/api/data-quality/v1/monitors).
*
* <p>The caller must either: 1. be an owner of the table's parent catalog 2. have **USE_CATALOG**
* on the table's parent catalog and be an owner of the table's parent schema 3. have the
Expand All @@ -87,7 +99,8 @@ public interface QualityMonitorsService {
MonitorRefreshListResponse listRefreshes(ListRefreshesRequest listRefreshesRequest);

/**
* Regenerates the monitoring dashboard for the specified table.
* [DEPRECATED] Regenerates the monitoring dashboard for the specified table. Use Data Quality
* Monitors API instead (/api/data-quality/v1/monitors).
*
* <p>The caller must either: 1. be an owner of the table's parent catalog 2. have **USE_CATALOG**
* on the table's parent catalog and be an owner of the table's parent schema 3. have the
Expand All @@ -101,7 +114,8 @@ RegenerateDashboardResponse regenerateDashboard(
RegenerateDashboardRequest regenerateDashboardRequest);

/**
* Queues a metric refresh on the monitor for the specified table. The refresh will execute in the
* [DEPRECATED] Queues a metric refresh on the monitor for the specified table. Use Data Quality
* Monitors API instead (/api/data-quality/v1/monitors). The refresh will execute in the
* background.
*
* <p>The caller must either: 1. be an owner of the table's parent catalog 2. have **USE_CATALOG**
Expand All @@ -114,7 +128,8 @@ RegenerateDashboardResponse regenerateDashboard(
MonitorRefreshInfo runRefresh(RunRefreshRequest runRefreshRequest);

/**
* Updates a monitor for the specified table.
* [DEPRECATED] Updates a monitor for the specified table. Use Data Quality Monitors API instead
* (/api/data-quality/v1/monitors).
*
* <p>The caller must either: 1. be an owner of the table's parent catalog 2. have **USE_CATALOG**
* on the table's parent catalog and be an owner of the table's parent schema 3. have the
Expand Down
Loading