### **Warning: Databricks strongly recommends that you protect the URLs that are returned by * the `EXTERNAL_LINKS` disposition.** * - *
When you use the `EXTERNAL_LINKS` disposition, a short-lived, URL is generated, which can be - * used to download the results directly from . As a short-lived is embedded in this URL, you - * should protect the URL. - * - *
Because URLs are already generated with embedded temporary s, you must not set an - * `Authorization` header in the download requests. + *
When you use the `EXTERNAL_LINKS` disposition, a short-lived cloud-storage URL is generated + * to download the results. The URL contains temporary access credentials, so protect it and do + * not set an `Authorization` header in the download request. * *
See [Execute Statement](:method:statementexecution/executestatement) for more details. * @@ -290,12 +287,9 @@ public GenieGetDownloadFullQueryResultResponse getDownloadFullQueryResult( *
### **Warning: Databricks strongly recommends that you protect the URLs that are returned by * the `EXTERNAL_LINKS` disposition.** * - *
When you use the `EXTERNAL_LINKS` disposition, a short-lived, URL is generated, which can be - * used to download the results directly from . As a short-lived is embedded in this URL, you - * should protect the URL. - * - *
Because URLs are already generated with embedded temporary s, you must not set an - * `Authorization` header in the download requests. + *
When you use the `EXTERNAL_LINKS` disposition, a short-lived cloud-storage URL is generated + * to download the results. The URL contains temporary access credentials, so protect it and do + * not set an `Authorization` header in the download request. * *
See [Execute Statement](:method:statementexecution/executestatement) for more details. * diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/dashboards/GenieService.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/dashboards/GenieService.java index 2452c18a6..2d39eaf14 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/dashboards/GenieService.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/dashboards/GenieService.java @@ -70,12 +70,9 @@ GenieGetMessageQueryResultResponse executeMessageQuery( *
### **Warning: Databricks strongly recommends that you protect the URLs that are returned by * the `EXTERNAL_LINKS` disposition.** * - *
When you use the `EXTERNAL_LINKS` disposition, a short-lived, URL is generated, which can be - * used to download the results directly from . As a short-lived is embedded in this URL, you - * should protect the URL. - * - *
Because URLs are already generated with embedded temporary s, you must not set an - * `Authorization` header in the download requests. + *
When you use the `EXTERNAL_LINKS` disposition, a short-lived cloud-storage URL is generated + * to download the results. The URL contains temporary access credentials, so protect it and do + * not set an `Authorization` header in the download request. * *
See [Execute Statement](:method:statementexecution/executestatement) for more details. * @@ -120,12 +117,9 @@ GenieListEvalResultsResponse genieListEvalResults( *
### **Warning: Databricks strongly recommends that you protect the URLs that are returned by * the `EXTERNAL_LINKS` disposition.** * - *
When you use the `EXTERNAL_LINKS` disposition, a short-lived, URL is generated, which can be - * used to download the results directly from . As a short-lived is embedded in this URL, you - * should protect the URL. - * - *
Because URLs are already generated with embedded temporary s, you must not set an - * `Authorization` header in the download requests. + *
When you use the `EXTERNAL_LINKS` disposition, a short-lived cloud-storage URL is generated + * to download the results. The URL contains temporary access credentials, so protect it and do + * not set an `Authorization` header in the download request. * *
See [Execute Statement](:method:statementexecution/executestatement) for more details. * diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/jobs/CreateJob.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/jobs/CreateJob.java index dd125abf3..9559a9eff 100644 --- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/jobs/CreateJob.java +++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/jobs/CreateJob.java @@ -60,11 +60,14 @@ public class CreateJob { private JobEmailNotifications emailNotifications; /** - * A list of task execution environment specifications that can be referenced by serverless tasks - * of this job. For serverless notebook tasks, if the environment_key is not specified, the - * notebook environment will be used if present. If a jobs environment is specified, it will - * override the notebook environment. For other serverless tasks, the task environment is required - * to be specified using environment_key in the task settings. + * A list of task execution environment specifications that can be referenced by tasks that use + * serverless compute or a compute resource that uses Environments mode. + * + *
For notebook tasks that use serverless compute or a compute resource that uses Environments
+ * mode, if the environment_key is not specified, the notebook environment will be used if
+ * present. If a jobs environment is specified, it will override the notebook environment. For
+ * other tasks that use serverless compute or a compute resource that uses Environments mode, the
+ * task environment is required to be specified using environment_key in the task settings.
*/
@JsonProperty("environments")
private Collection For notebook tasks that use serverless compute or a compute resource that uses Environments
+ * mode, if the environment_key is not specified, the notebook environment will be used if
+ * present. If a jobs environment is specified, it will override the notebook environment. For
+ * other tasks that use serverless compute or a compute resource that uses Environments mode, the
+ * task environment is required to be specified using environment_key in the task settings.
*/
@JsonProperty("environments")
private Collection [MLflow Model permissions]:
+ * https://docs.databricks.com/aws/en/machine-learning/manage-model-lifecycle/workspace-model-registry#permissions
*/
@Generated
public enum PermissionLevel {
diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/AmazonBedrockConfig.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/AmazonBedrockConfig.java
index 430410354..10c0292ce 100644
--- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/AmazonBedrockConfig.java
+++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/serving/AmazonBedrockConfig.java
@@ -65,6 +65,13 @@ public class AmazonBedrockConfig {
@JsonProperty("instance_profile_arn")
private String instanceProfileArn;
+ /**
+ * The name of the Unity Catalog service credential that the external model uses to access AWS
+ * resources.
+ */
+ @JsonProperty("uc_service_credential_name")
+ private String ucServiceCredentialName;
+
public AmazonBedrockConfig setAwsAccessKeyId(String awsAccessKeyId) {
this.awsAccessKeyId = awsAccessKeyId;
return this;
@@ -129,6 +136,15 @@ public String getInstanceProfileArn() {
return instanceProfileArn;
}
+ public AmazonBedrockConfig setUcServiceCredentialName(String ucServiceCredentialName) {
+ this.ucServiceCredentialName = ucServiceCredentialName;
+ return this;
+ }
+
+ public String getUcServiceCredentialName() {
+ return ucServiceCredentialName;
+ }
+
@Override
public boolean equals(Object o) {
if (this == o) return true;
@@ -140,7 +156,8 @@ public boolean equals(Object o) {
&& Objects.equals(awsSecretAccessKey, that.awsSecretAccessKey)
&& Objects.equals(awsSecretAccessKeyPlaintext, that.awsSecretAccessKeyPlaintext)
&& Objects.equals(bedrockProvider, that.bedrockProvider)
- && Objects.equals(instanceProfileArn, that.instanceProfileArn);
+ && Objects.equals(instanceProfileArn, that.instanceProfileArn)
+ && Objects.equals(ucServiceCredentialName, that.ucServiceCredentialName);
}
@Override
@@ -152,7 +169,8 @@ public int hashCode() {
awsSecretAccessKey,
awsSecretAccessKeyPlaintext,
bedrockProvider,
- instanceProfileArn);
+ instanceProfileArn,
+ ucServiceCredentialName);
}
@Override
@@ -165,6 +183,7 @@ public String toString() {
.add("awsSecretAccessKeyPlaintext", awsSecretAccessKeyPlaintext)
.add("bedrockProvider", bedrockProvider)
.add("instanceProfileArn", instanceProfileArn)
+ .add("ucServiceCredentialName", ucServiceCredentialName)
.toString();
}
}
diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/settings/CustomerFacingIngressNetworkPolicyWorkspaceApiDestination.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/settings/CustomerFacingIngressNetworkPolicyWorkspaceApiDestination.java
index 111f4f8ef..4a4e561b8 100644
--- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/settings/CustomerFacingIngressNetworkPolicyWorkspaceApiDestination.java
+++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/settings/CustomerFacingIngressNetworkPolicyWorkspaceApiDestination.java
@@ -11,6 +11,13 @@
/** Matches workspace-level Databricks API endpoints for an ingress network policy rule. */
@Generated
public class CustomerFacingIngressNetworkPolicyWorkspaceApiDestination {
+ /**
+ * Inverse of `scopes`: matches every API scope EXCEPT those listed here ("allow all except").
+ * Mutually exclusive with `scopes` — a single destination may set at most one of the two.
+ */
+ @JsonProperty("excluded_scopes")
+ private Collection 2. These are URLs with a specific expiration, indicated in the response. The behavior when
- * attempting to use an expired link is cloud specific.
+ * 2. These are short-lived cloud-storage URLs with a specific expiration, indicated in the
+ * response. The behavior when attempting to use an expired link is cloud specific.
*/
@JsonProperty("disposition")
private Disposition disposition;
diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/ExternalLink.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/ExternalLink.java
index 569281981..c56793c91 100644
--- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/ExternalLink.java
+++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/ExternalLink.java
@@ -29,9 +29,10 @@ public class ExternalLink {
private String expiration;
/**
- * A URL pointing to a chunk of result data, hosted by an external service, with a short
- * expiration time (<= 15 minutes). As this URL contains a temporary credential, it should be
- * considered sensitive and the client should not expose this URL in a log.
+ * A short-lived cloud-storage URL pointing to a chunk of result data, hosted by an external
+ * service, with a short expiration time (<= 15 minutes). As this URL contains a temporary
+ * credential, it should be considered sensitive and the client should not expose this URL in a
+ * log.
*/
@JsonProperty("external_link")
private String externalLink;
diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/ResultData.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/ResultData.java
index 217e370f9..7dac3a3c2 100644
--- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/ResultData.java
+++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/ResultData.java
@@ -10,10 +10,10 @@
/**
* Contains the result data of a single chunk when using `INLINE` disposition. When using
- * `EXTERNAL_LINKS` disposition, the array `external_links` is used instead to provide URLs to the
- * result data in cloud storage. Exactly one of these alternatives is used. (While the
- * `external_links` array prepares the API to return multiple links in a single response. Currently
- * only a single link is returned.)
+ * `EXTERNAL_LINKS` disposition, the array `external_links` is used instead to provide short-lived
+ * cloud-storage URLs to the result data in cloud storage. Exactly one of these alternatives is
+ * used. (While the `external_links` array prepares the API to return multiple links in a single
+ * response. Currently only a single link is returned.)
*/
@Generated
public class ResultData {
diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/StatementExecutionAPI.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/StatementExecutionAPI.java
index 1f84dd01d..95b392607 100644
--- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/StatementExecutionAPI.java
+++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/StatementExecutionAPI.java
@@ -135,29 +135,26 @@ public void cancelExecution(CancelExecutionRequest request) {
*
* Using `EXTERNAL_LINKS` to fetch result data allows you to fetch large result sets
* efficiently. The main differences from using `INLINE` disposition are that the result data is
- * accessed with URLs, and that there are 3 supported formats: `JSON_ARRAY`, `ARROW_STREAM` and
- * `CSV` compared to only `JSON_ARRAY` with `INLINE`.
+ * accessed with short-lived cloud-storage URLs, and that there are 3 supported formats:
+ * `JSON_ARRAY`, `ARROW_STREAM` and `CSV` compared to only `JSON_ARRAY` with `INLINE`.
*
- * ** URLs**
+ * **External-link URLs**
*
- * External links point to data stored within your workspace's internal storage, in the form of
- * a URL. The URLs are valid for only a short period, <= 15 minutes. Alongside each
- * `external_link` is an expiration field indicating the time at which the URL is no longer valid.
- * In `EXTERNAL_LINKS` mode, chunks can be resolved and fetched multiple times and in parallel.
+ * External links point to data stored within your workspace's internal cloud storage. The URLs
+ * are valid for only a short period, <= 15 minutes. Alongside each `external_link` is an
+ * expiration field indicating the time at which the URL is no longer valid. In `EXTERNAL_LINKS`
+ * mode, chunks can be resolved and fetched multiple times and in parallel.
*
* ----
*
* ### **Warning: Databricks strongly recommends that you protect the URLs that are returned by
* the `EXTERNAL_LINKS` disposition.**
*
- * When you use the `EXTERNAL_LINKS` disposition, a short-lived, URL is generated, which can be
- * used to download the results directly from . As a short-lived is embedded in this URL, you
- * should protect the URL.
+ * When you use the `EXTERNAL_LINKS` disposition, a short-lived cloud-storage URL is generated
+ * to download the results. The URL contains temporary access credentials, so protect it and do
+ * not set an `Authorization` header in the download request.
*
- * Because URLs are already generated with embedded temporary s, you must not set an
- * `Authorization` header in the download requests.
- *
- * The `EXTERNAL_LINKS` disposition can be disabled upon request by creating a support case.
+ * The `EXTERNAL_LINKS` disposition can be disabled upon request by creating a [support case].
*
* See also [Security best practices].
*
@@ -171,6 +168,7 @@ public void cancelExecution(CancelExecutionRequest request) {
*
* [Security best practices]:
* https://docs.databricks.com/sql/admin/sql-execution-tutorial.html#security-best-practices
+ * [support case]: https://docs.databricks.com/resources/support.html
*/
public StatementResponse executeStatement(ExecuteStatementRequest request) {
return impl.executeStatement(request);
diff --git a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/StatementExecutionService.java b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/StatementExecutionService.java
index 8cad20969..9218df67d 100644
--- a/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/StatementExecutionService.java
+++ b/databricks-sdk-java/src/main/java/com/databricks/sdk/service/sql/StatementExecutionService.java
@@ -120,29 +120,26 @@ public interface StatementExecutionService {
*
* Using `EXTERNAL_LINKS` to fetch result data allows you to fetch large result sets
* efficiently. The main differences from using `INLINE` disposition are that the result data is
- * accessed with URLs, and that there are 3 supported formats: `JSON_ARRAY`, `ARROW_STREAM` and
- * `CSV` compared to only `JSON_ARRAY` with `INLINE`.
+ * accessed with short-lived cloud-storage URLs, and that there are 3 supported formats:
+ * `JSON_ARRAY`, `ARROW_STREAM` and `CSV` compared to only `JSON_ARRAY` with `INLINE`.
*
- * ** URLs**
+ * **External-link URLs**
*
- * External links point to data stored within your workspace's internal storage, in the form of
- * a URL. The URLs are valid for only a short period, <= 15 minutes. Alongside each
- * `external_link` is an expiration field indicating the time at which the URL is no longer valid.
- * In `EXTERNAL_LINKS` mode, chunks can be resolved and fetched multiple times and in parallel.
+ * External links point to data stored within your workspace's internal cloud storage. The URLs
+ * are valid for only a short period, <= 15 minutes. Alongside each `external_link` is an
+ * expiration field indicating the time at which the URL is no longer valid. In `EXTERNAL_LINKS`
+ * mode, chunks can be resolved and fetched multiple times and in parallel.
*
* ----
*
* ### **Warning: Databricks strongly recommends that you protect the URLs that are returned by
* the `EXTERNAL_LINKS` disposition.**
*
- * When you use the `EXTERNAL_LINKS` disposition, a short-lived, URL is generated, which can be
- * used to download the results directly from . As a short-lived is embedded in this URL, you
- * should protect the URL.
+ * When you use the `EXTERNAL_LINKS` disposition, a short-lived cloud-storage URL is generated
+ * to download the results. The URL contains temporary access credentials, so protect it and do
+ * not set an `Authorization` header in the download request.
*
- * Because URLs are already generated with embedded temporary s, you must not set an
- * `Authorization` header in the download requests.
- *
- * The `EXTERNAL_LINKS` disposition can be disabled upon request by creating a support case.
+ * The `EXTERNAL_LINKS` disposition can be disabled upon request by creating a [support case].
*
* See also [Security best practices].
*
@@ -156,6 +153,7 @@ public interface StatementExecutionService {
*
* [Security best practices]:
* https://docs.databricks.com/sql/admin/sql-execution-tutorial.html#security-best-practices
+ * [support case]: https://docs.databricks.com/resources/support.html
*/
StatementResponse executeStatement(ExecuteStatementRequest executeStatementRequest);