Skip to content

feat: [sql] added an optional application field to ExecuteSqlRequest to support application-level telemetry and audit logging #7042

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
gcf-owl-bot wants to merge 4 commits into
base: main
Choose a base branch
from
+472 −49
Open

feat: [sql] added an optional application field to ExecuteSqlRequest to support application-level telemetry and audit logging #7042

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
35510d0
feat: added an optional `application` field to `ExecuteSqlRequest` to…
gcf-owl-bot[bot] Jan 27, 2026
4b7574b
🦉 Updates from OwlBot post-processor
gcf-owl-bot[bot] Jan 27, 2026
01a1dcd
feat: added an optional `application` field to `ExecuteSqlRequest` to…
gcf-owl-bot[bot] Jan 27, 2026
8e0c31c
🦉 Updates from OwlBot post-processor
gcf-owl-bot[bot] Jan 27, 2026
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 ...s/google-cloud-sql/protos/google/cloud/sql/v1/cloud_sql_available_database_versions.proto
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
// Copyright 2025 Google LLC
// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
Expand Down
2 changes: 1 addition & 1 deletion packages/google-cloud-sql/protos/google/cloud/sql/v1/cloud_sql_backup_runs.proto
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
// Copyright 2025 Google LLC
// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
Expand Down
2 changes: 1 addition & 1 deletion packages/google-cloud-sql/protos/google/cloud/sql/v1/cloud_sql_backups.proto
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
// Copyright 2025 Google LLC
// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
Expand Down
2 changes: 1 addition & 1 deletion packages/google-cloud-sql/protos/google/cloud/sql/v1/cloud_sql_connect.proto
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
// Copyright 2025 Google LLC
// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
Expand Down
2 changes: 1 addition & 1 deletion packages/google-cloud-sql/protos/google/cloud/sql/v1/cloud_sql_databases.proto
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
// Copyright 2025 Google LLC
// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
Expand Down
2 changes: 1 addition & 1 deletion packages/google-cloud-sql/protos/google/cloud/sql/v1/cloud_sql_events.proto
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
// Copyright 2025 Google LLC
// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
Expand Down
2 changes: 1 addition & 1 deletion packages/google-cloud-sql/protos/google/cloud/sql/v1/cloud_sql_feature_eligibility.proto
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
// Copyright 2025 Google LLC
// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
Expand Down
2 changes: 1 addition & 1 deletion packages/google-cloud-sql/protos/google/cloud/sql/v1/cloud_sql_flags.proto
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
// Copyright 2025 Google LLC
// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
Expand Down
2 changes: 1 addition & 1 deletion packages/google-cloud-sql/protos/google/cloud/sql/v1/cloud_sql_iam_policies.proto
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
// Copyright 2025 Google LLC
// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
Expand Down
2 changes: 1 addition & 1 deletion packages/google-cloud-sql/protos/google/cloud/sql/v1/cloud_sql_instance_names.proto
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
// Copyright 2025 Google LLC
// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
Expand Down
7 changes: 6 additions & 1 deletion packages/google-cloud-sql/protos/google/cloud/sql/v1/cloud_sql_instances.proto
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
// Copyright 2025 Google LLC
// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
Expand Down Expand Up @@ -2311,6 +2311,11 @@ message ExecuteSqlPayload {
// to throw an error.
PartialResultMode partial_result_mode = 13
[(google.api.field_behavior) = OPTIONAL];

// Optional. Specifies the name of the application that is making the request.
// This field is used for telemetry. Only alphanumeric characters, dashes, and
// underscores are allowed. The maximum length is 32 characters.
string application = 16 [(google.api.field_behavior) = OPTIONAL];
}

// Execute SQL statements response.
Expand Down
2 changes: 1 addition & 1 deletion packages/google-cloud-sql/protos/google/cloud/sql/v1/cloud_sql_operations.proto
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
// Copyright 2025 Google LLC
// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
Expand Down
2 changes: 1 addition & 1 deletion packages/google-cloud-sql/protos/google/cloud/sql/v1/cloud_sql_regions.proto
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
// Copyright 2025 Google LLC
// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
Expand Down
35 changes: 30 additions & 5 deletions packages/google-cloud-sql/protos/google/cloud/sql/v1/cloud_sql_resources.proto
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
// Copyright 2025 Google LLC
// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
Expand Down Expand Up @@ -2121,6 +2121,9 @@ enum SqlDatabaseVersion {
// The database version is MySQL 8.4.
MYSQL_8_4 = 398;

// The database version is MySQL 9.7.
MYSQL_9_7 = 654;

// The database version is SQL Server 2017 Standard.
SQLSERVER_2017_STANDARD = 11;

Expand Down Expand Up @@ -2288,6 +2291,7 @@ message AcquireSsrsLeaseContext {
// DNS metadata.
message DnsNameMapping {
// The connection type of the DNS name.
// This enum is not frozen, and new values may be added in the future.
enum ConnectionType {
// Unknown connection type.
CONNECTION_TYPE_UNSPECIFIED = 0;
Expand All @@ -2304,20 +2308,41 @@ message DnsNameMapping {

// The scope that the DNS name applies to.
enum DnsScope {
// Unknown DNS scope.
// DNS scope not set. This value should not be used.
DNS_SCOPE_UNSPECIFIED = 0;

// Indicates a instance-level DNS name.
// Indicates an instance-level DNS name.
INSTANCE = 1;

// Indicates a cluster-level DNS name.
CLUSTER = 2;
}

// The DNS name.
string name = 1;
// The system responsible for managing the DNS record.
enum RecordManager {
// Record manager not set. This value should not be used.
RECORD_MANAGER_UNSPECIFIED = 0;

// The record may be managed by the customer. It is not automatically
// managed by Cloud SQL automation.
CUSTOMER = 1;

// The record is managed by Cloud SQL, which will create, update,
// and delete the DNS records for the zone automatically when
// the Cloud SQL database instance is created or updated.
CLOUD_SQL_AUTOMATION = 2;
}

// Output only. The DNS name.
string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY];

// Output only. The connection type of the DNS name.
ConnectionType connection_type = 2
[(google.api.field_behavior) = OUTPUT_ONLY];

// Output only. The scope that the DNS name applies to.
DnsScope dns_scope = 3 [(google.api.field_behavior) = OUTPUT_ONLY];

// Output only. The manager for this DNS record.
RecordManager record_manager = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
}
2 changes: 1 addition & 1 deletion packages/google-cloud-sql/protos/google/cloud/sql/v1/cloud_sql_ssl_certs.proto
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
// Copyright 2025 Google LLC
// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
Expand Down
2 changes: 1 addition & 1 deletion packages/google-cloud-sql/protos/google/cloud/sql/v1/cloud_sql_tiers.proto
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
// Copyright 2025 Google LLC
// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
Expand Down
2 changes: 1 addition & 1 deletion packages/google-cloud-sql/protos/google/cloud/sql/v1/cloud_sql_users.proto
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
// Copyright 2025 Google LLC
// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
Expand Down
11 changes: 8 additions & 3 deletions packages/google-cloud-sql/protos/google/cloud/sql/v1beta4/cloud_sql.proto
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
// Copyright 2025 Google LLC
// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
Expand Down Expand Up @@ -1560,8 +1560,8 @@ message ExecuteSqlPayload {
// Unspecified mode, effectively the same as `FAIL_PARTIAL_RESULT`.
PARTIAL_RESULT_MODE_UNSPECIFIED = 0;

// Throw an error if the result exceeds 10 MB or if a partial result can be
// retrieved. Don't return the result.
// Throw an error if the result exceeds 10 MB or if only a partial result
// can be retrieved. Don't return the result.
FAIL_PARTIAL_RESULT = 1;

// Return a truncated result and set `partial_result` to true if the result
Expand Down Expand Up @@ -1598,6 +1598,11 @@ message ExecuteSqlPayload {
// to throw an error.
PartialResultMode partial_result_mode = 13
[(google.api.field_behavior) = OPTIONAL];

// Optional. Specifies the name of the application that is making the request.
// This field is used for telemetry. Only alphanumeric characters, dashes, and
// underscores are allowed. The maximum length is 32 characters.
string application = 16 [(google.api.field_behavior) = OPTIONAL];
}

// Execute SQL statements response.
Expand Down
2 changes: 1 addition & 1 deletion packages/google-cloud-sql/protos/google/cloud/sql/v1beta4/cloud_sql_connect.proto
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
// Copyright 2025 Google LLC
// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
Expand Down
2 changes: 1 addition & 1 deletion packages/google-cloud-sql/protos/google/cloud/sql/v1beta4/cloud_sql_iam_policies.proto
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
// Copyright 2025 Google LLC
// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
Expand Down
34 changes: 29 additions & 5 deletions packages/google-cloud-sql/protos/google/cloud/sql/v1beta4/cloud_sql_resources.proto
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
// Copyright 2025 Google LLC
// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
Expand Down Expand Up @@ -978,22 +978,43 @@ message DnsNameMapping {

// The scope that the DNS name applies to.
enum DnsScope {
// Unknown DNS scope.
// DNS scope not set. This value should not be used.
DNS_SCOPE_UNSPECIFIED = 0;

// Indicates a instance-level DNS name.
// Indicates an instance-level DNS name.
INSTANCE = 1;

// Indicates a cluster-level DNS name.
CLUSTER = 2;
}

// The DNS name.
string name = 1;
// The system responsible for managing the DNS record.
enum RecordManager {
// Record manager not set. This value should not be used.
RECORD_MANAGER_UNSPECIFIED = 0;

// The record may be managed by the customer. It is not automatically
// managed by Cloud SQL automation.
CUSTOMER = 1;

// The record is managed by Cloud SQL, which will create, update, and delete
// the DNS records for the zone automatically when the Cloud SQL database
// instance is created or updated.
CLOUD_SQL_AUTOMATION = 2;
}

// Output only. The DNS name.
string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY];

// Output only. The connection type of the DNS name.
ConnectionType connection_type = 2
[(google.api.field_behavior) = OUTPUT_ONLY];

// Output only. The scope that the DNS name applies to.
DnsScope dns_scope = 3 [(google.api.field_behavior) = OUTPUT_ONLY];

// Output only. The manager for this DNS record.
RecordManager record_manager = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
}

// Gemini instance configuration.
Expand Down Expand Up @@ -3809,6 +3830,9 @@ enum SqlDatabaseVersion {
// The database version is MySQL 8.4.
MYSQL_8_4 = 398;

// The database version is MySQL 9.7.
MYSQL_9_7 = 654;

// The database version is SQL Server 2017 Standard.
SQLSERVER_2017_STANDARD = 11;

Expand Down
2 changes: 1 addition & 1 deletion packages/google-cloud-sql/protos/google/cloud/sql/v1beta4/cloud_sql_tiers.proto
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
// Copyright 2025 Google LLC
// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
Expand Down
2 changes: 1 addition & 1 deletion packages/google-cloud-sql/protos/google/cloud/sql/v1beta4/cloud_sql_users.proto
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
// Copyright 2025 Google LLC
// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
Expand Down
Loading
Loading