diff --git a/.codegen/_last_sha b/.codegen/_last_sha index b2c9c89d9..d583f8ce5 100644 --- a/.codegen/_last_sha +++ b/.codegen/_last_sha @@ -1 +1 @@ -b8604ef9fce0fe42f56306cd36ef5e11e013074a \ No newline at end of file +ced34d63e64d234affc3213758ac687edbf6f3c3 \ No newline at end of file diff --git a/CHANGELOG.md b/CHANGELOG.md index cab8ca62a..4893cd768 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,10 @@ # Version changelog +## Release v0.176.0 (2026-11-05) + +### API Changes +* Add `undropMetastoreById()` method for `workspaceClient.metastores()` service. + ## Release v0.175.0 (2026-11-04) ### API Changes diff --git a/databricks-sdk-java/lockfile.json b/databricks-sdk-java/lockfile.json index 93e2e7e80..ead6f1f84 100644 --- a/databricks-sdk-java/lockfile.json +++ b/databricks-sdk-java/lockfile.json @@ -1,7 +1,7 @@ { "artifactId": "databricks-sdk-java", "groupId": "com.databricks", - "version": "0.175.0", + "version": "0.176.0", "lockFileVersion": 1, "dependencies": [ { diff --git a/databricks-sdk-java/pom.xml b/databricks-sdk-java/pom.xml index a6bbe65c6..af2e1e178 100644 --- a/databricks-sdk-java/pom.xml +++ b/databricks-sdk-java/pom.xml @@ -5,7 +5,7 @@ com.databricks databricks-sdk-parent - 0.175.0 + 0.176.0 databricks-sdk-java Databricks SDK for Java diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/UserAgent.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/UserAgent.java index 97a8a79e9..7a952641b 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/core/UserAgent.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/core/UserAgent.java @@ -36,7 +36,7 @@ public String getValue() { // TODO: check if reading from // /META-INF/maven/com.databricks/databrics-sdk-java/pom.properties // or getClass().getPackage().getImplementationVersion() is enough. - private static final String version = "0.175.0"; + private static final String version = "0.176.0"; public static void withProduct(String product, String productVersion) { UserAgent.product = product; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/catalog/MetastoresAPI.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/catalog/MetastoresAPI.java index 4704e9712..f1932f96e 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/catalog/MetastoresAPI.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/catalog/MetastoresAPI.java @@ -129,6 +129,15 @@ public void unassign(UnassignRequest request) { impl.unassign(request); } + /** + * Restores a soft-deleted metastore identified by its ID. The caller must be an account admin. A + * metastore may be eligible for restoration for up to five days after deletion. Restoration may + * become unavailable earlier once permanent deletion begins. Returns the restored metastore. + */ + public MetastoreInfo undropMetastoreById(UndropMetastoreByIdRequest request) { + return impl.undropMetastoreById(request); + } + /** * Updates information for a specific metastore. The caller must be a metastore admin. If the * __owner__ field is set to the empty string (**""**), the ownership is updated to the System diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/catalog/MetastoresImpl.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/catalog/MetastoresImpl.java index 99217eb5a..2cdfcdce5 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/catalog/MetastoresImpl.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/catalog/MetastoresImpl.java @@ -154,6 +154,24 @@ public void unassign(UnassignRequest request) { } } + @Override + public MetastoreInfo undropMetastoreById(UndropMetastoreByIdRequest request) { + String path = "/api/2.1/unity-catalog/metastores:undropById"; + try { + Request req = new Request("POST", path, apiClient.serialize(request)); + + ApiClient.setQuery(req, request); + req.withHeader("Accept", "application/json"); + req.withHeader("Content-Type", "application/json"); + if (apiClient.workspaceId() != null) { + req.withHeader("X-Databricks-Workspace-Id", apiClient.workspaceId()); + } + return apiClient.execute(req, MetastoreInfo.class); + } catch (IOException e) { + throw new DatabricksException("IO error: " + e.getMessage(), e); + } + } + @Override public MetastoreInfo update(UpdateMetastore request) { String path = String.format("/api/2.1/unity-catalog/metastores/%s", request.getId()); diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/catalog/MetastoresService.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/catalog/MetastoresService.java index 7efb89b22..6479bb644 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/catalog/MetastoresService.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/catalog/MetastoresService.java @@ -73,6 +73,13 @@ public interface MetastoresService { /** Deletes a metastore assignment. The caller must be an account administrator. */ void unassign(UnassignRequest unassignRequest); + /** + * Restores a soft-deleted metastore identified by its ID. The caller must be an account admin. A + * metastore may be eligible for restoration for up to five days after deletion. Restoration may + * become unavailable earlier once permanent deletion begins. Returns the restored metastore. + */ + MetastoreInfo undropMetastoreById(UndropMetastoreByIdRequest undropMetastoreByIdRequest); + /** * Updates information for a specific metastore. The caller must be a metastore admin. If the * __owner__ field is set to the empty string (**""**), the ownership is updated to the System diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/catalog/UndropMetastoreByIdRequest.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/catalog/UndropMetastoreByIdRequest.java new file mode 100644 index 000000000..85694320a --- /dev/null +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/catalog/UndropMetastoreByIdRequest.java @@ -0,0 +1,43 @@ +// Code generated from OpenAPI specs by Databricks SDK Generator. DO NOT EDIT. + +package com.databricks.sdk.service.catalog; + +import com.databricks.sdk.support.Generated; +import com.databricks.sdk.support.ToStringer; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.Objects; + +/** Request to restore a soft-deleted metastore by ID. */ +@Generated +public class UndropMetastoreByIdRequest { + /** Required. Id of the metastore to undrop. */ + @JsonProperty("id") + private String id; + + public UndropMetastoreByIdRequest setId(String id) { + this.id = id; + return this; + } + + public String getId() { + return id; + } + + @Override + public boolean equals(Object o) { + if (this == o) return true; + if (o == null || getClass() != o.getClass()) return false; + UndropMetastoreByIdRequest that = (UndropMetastoreByIdRequest) o; + return Objects.equals(id, that.id); + } + + @Override + public int hashCode() { + return Objects.hash(id); + } + + @Override + public String toString() { + return new ToStringer(UndropMetastoreByIdRequest.class).add("id", id).toString(); + } +} diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/ml/CronSchedule.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/ml/CronSchedule.java index 5788d8334..9aaeba5c5 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/ml/CronSchedule.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/ml/CronSchedule.java @@ -7,7 +7,7 @@ import com.fasterxml.jackson.annotation.JsonProperty; import java.util.Objects; -/** A cron-based schedule trigger for the materialization pipeline. */ +/** A cron-based schedule trigger for batch materialization. */ @Generated public class CronSchedule { /** diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/ml/FeatureEngineeringAPI.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/ml/FeatureEngineeringAPI.java index c96777c8c..2b9fd07c9 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/ml/FeatureEngineeringAPI.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/ml/FeatureEngineeringAPI.java @@ -300,9 +300,11 @@ public KafkaConfig updateKafkaConfig(UpdateKafkaConfigRequest request) { } /** - * Update the materialization set's state to match the supplied materialization set. Changes are - * applied member by member and are not atomic: when one member fails, the error reports which - * members were already changed. + * Updates a materialization set. Supports changing pause settings and deleting materialized + * features from the set. + * + *

Changes are not atomic. Some updates or deletions may succeed even if the operation fails. + * Individual outcomes are available in `MaterializationSetUpdateProgress`. */ public UpdateMaterializationSetOperation updateMaterializationSet( UpdateMaterializationSetRequest request) { diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/ml/FeatureEngineeringService.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/ml/FeatureEngineeringService.java index d7339410a..8a8fdfc5c 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/ml/FeatureEngineeringService.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/ml/FeatureEngineeringService.java @@ -128,9 +128,11 @@ ListMaterializedFeaturesResponse listMaterializedFeatures( KafkaConfig updateKafkaConfig(UpdateKafkaConfigRequest updateKafkaConfigRequest); /** - * Update the materialization set's state to match the supplied materialization set. Changes are - * applied member by member and are not atomic: when one member fails, the error reports which - * members were already changed. + * Updates a materialization set. Supports changing pause settings and deleting materialized + * features from the set. + * + *

Changes are not atomic. Some updates or deletions may succeed even if the operation fails. + * Individual outcomes are available in `MaterializationSetUpdateProgress`. */ Operation updateMaterializationSet( UpdateMaterializationSetRequest updateMaterializationSetRequest); diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/ml/MaterializationSet.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/ml/MaterializationSet.java index 6ea4a2756..1e6dc36bb 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/ml/MaterializationSet.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/ml/MaterializationSet.java @@ -16,8 +16,9 @@ public class MaterializationSet { private String materializationSetId; /** - * The materialized features in this set. Order is not significant. Updating the set with a - * materialized feature removed from this set will cause it to be deleted. + * The materialized features in this set. Order is not significant. An `UpdateMaterializationSet` + * request with `materialized_features` or `*` in its update mask deletes omitted materialized + * features. */ @JsonProperty("materialized_features") private Collection materializedFeatures; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/ml/MaterializationSetUpdateProgress.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/ml/MaterializationSetUpdateProgress.java index c46d194f9..80745553e 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/ml/MaterializationSetUpdateProgress.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/ml/MaterializationSetUpdateProgress.java @@ -8,21 +8,18 @@ import java.util.Collection; import java.util.Objects; -/** - * What a partly failed UpdateMaterializationSet got through, attached to the error so a caller can - * tell which materialized feature members already changed and which ones did not and why it failed. - */ +/** Progress and outcomes of an `UpdateMaterializationSet` operation. */ @Generated public class MaterializationSetUpdateProgress { - /** Materialized feature members that were deleted from the materialization set. */ + /** IDs of materialized features that were deleted. */ @JsonProperty("deleted_materialized_feature_ids") private Collection deletedMaterializedFeatureIds; - /** Materialized feature members that could not be updated, one entry each. */ + /** Materialized features that could not be updated or deleted, one entry each. */ @JsonProperty("failed_materialized_features") private Collection failedMaterializedFeatures; - /** Materialized feature members whose mutable state was updated. */ + /** IDs of materialized features whose mutable state was updated. */ @JsonProperty("updated_materialized_feature_ids") private Collection updatedMaterializedFeatureIds; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/ml/MaterializedFeature.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/ml/MaterializedFeature.java index bafc91b1c..1d4e89dae 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/ml/MaterializedFeature.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/ml/MaterializedFeature.java @@ -22,7 +22,7 @@ public class MaterializedFeature { @JsonProperty("cron_schedule") private String cronSchedule; - /** A cron-based schedule trigger for the materialization pipeline. */ + /** A cron-based schedule trigger for batch materialization. */ @JsonProperty("cron_schedule_trigger") private CronSchedule cronScheduleTrigger; @@ -112,7 +112,7 @@ public class MaterializedFeature { @JsonProperty("table_name") private String tableName; - /** A trigger that fires when the upstream source table changes. */ + /** A trigger that starts batch materialization when the upstream source table changes. */ @JsonProperty("table_trigger") private TableTrigger tableTrigger; diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/ml/TableTrigger.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/ml/TableTrigger.java index ad07b3932..534ad28ed 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/ml/TableTrigger.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/ml/TableTrigger.java @@ -9,8 +9,8 @@ import java.util.Objects; /** - * A trigger that fires when the feature's source table changes: a DeltaTableSource's table, or an - * SdpSource's input_tables. + * A trigger that starts batch materialization when the feature's source table changes: a + * DeltaTableSource's table, or an SdpSource's input_tables. */ @Generated public class TableTrigger { diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/ml/UpdateMaterializationSetRequest.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/ml/UpdateMaterializationSetRequest.java index 3ffc73929..5758838e0 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/ml/UpdateMaterializationSetRequest.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/ml/UpdateMaterializationSetRequest.java @@ -13,7 +13,10 @@ @Generated public class UpdateMaterializationSetRequest { /** - * The desired state of the updated materialization set. materialization_set_id selects the set. + * The desired state of the materialization set. `materialization_set_id` identifies the set. + * + *

A request that changes pause settings must request the same `paused` value for all retained + * members with a cron schedule or table trigger. */ @JsonProperty("materialization_set") private MaterializationSet materializationSet; @@ -31,7 +34,20 @@ public class UpdateMaterializationSetRequest { @QueryParam("request_id") private String requestId; - /** The fields to update. Only 'materialized_features' or '*' is supported. */ + /** + * The fields to update, relative to the materialization set. Supported values are + * `materialized_features` and `*`. + * + *

The `materialized_features` mask updates retained members and deletes omitted materialized + * features. The `*` mask selects all fields of the set and follows the same membership rules. + * Adding members is not supported. + * + *

To change pause settings without changing membership, include every member of the set. An + * omitted `paused` is reset to `false`. + * + *

Fields outside the mask are unchanged. Trigger types and settings other than `paused` must + * remain unchanged. + */ @JsonIgnore @QueryParam("update_mask") private FieldMask updateMask; diff --git a/examples/docs/pom.xml b/examples/docs/pom.xml index d7752722f..0b878cbdb 100644 --- a/examples/docs/pom.xml +++ b/examples/docs/pom.xml @@ -24,7 +24,7 @@ com.databricks databricks-sdk-java - 0.175.0 + 0.176.0 diff --git a/examples/spring-boot-oauth-u2m-demo/pom.xml b/examples/spring-boot-oauth-u2m-demo/pom.xml index 81058c03c..4d32bff5f 100644 --- a/examples/spring-boot-oauth-u2m-demo/pom.xml +++ b/examples/spring-boot-oauth-u2m-demo/pom.xml @@ -40,7 +40,7 @@ com.databricks databricks-sdk-java - 0.175.0 + 0.176.0 diff --git a/lockfile.json b/lockfile.json index bcc9311b7..5a9c539d9 100644 --- a/lockfile.json +++ b/lockfile.json @@ -1,7 +1,7 @@ { "artifactId": "databricks-sdk-parent", "groupId": "com.databricks", - "version": "0.175.0", + "version": "0.176.0", "lockFileVersion": 1, "dependencies": [], "mavenPlugins": [], diff --git a/pom.xml b/pom.xml index 71a18fce8..099338c23 100644 --- a/pom.xml +++ b/pom.xml @@ -4,7 +4,7 @@ 4.0.0 com.databricks databricks-sdk-parent - 0.175.0 + 0.176.0 pom Databricks SDK for Java The Databricks SDK for Java includes functionality to accelerate development with Java for diff --git a/shaded/pom.xml b/shaded/pom.xml index 7abb855b0..d6151f065 100644 --- a/shaded/pom.xml +++ b/shaded/pom.xml @@ -4,7 +4,7 @@ 4.0.0 - 0.175.0 + 0.176.0 com.databricks