feat(bigquery): update the api

#### bigquery:v2 The following keys were deleted: - schemas.Explanation (Total Keys: 5) - schemas.GlobalExplanation (Total Keys: 5) - schemas.JobStatistics.properties.sessionInfoTemplate.$ref (Total Keys: 1) - schemas.JobStatistics2.properties.dmlStats.type (Total Keys: 1) - schemas.QueryResponse.properties.dmlStats.type (Total Keys: 1) - schemas.TrainingRun.properties.globalExplanations (Total Keys: 2) The following keys were added: - schemas.BiEngineReason (Total Keys: 6) - schemas.BiEngineStatistics (Total Keys: 6) - schemas.DmlStatistics (Total Keys: 8) - schemas.JobStatistics.properties.sessionInfo.$ref (Total Keys: 1) - schemas.JobStatistics2.properties.biEngineStatistics.$ref (Total Keys: 1) - schemas.JobStatistics2.properties.dmlStats.$ref (Total Keys: 1) - schemas.QueryResponse.properties.dmlStats.$ref (Total Keys: 1)
googleapis · Jun 29, 2021 · 59c51e3 · 59c51e3
1 parent 6b60d64
commit 59c51e3
Show file tree

Hide file tree

Showing 3 changed files with 145 additions and 102 deletions.
diff --git a/docs/dyn/bigquery_v2.jobs.html b/docs/dyn/bigquery_v2.jobs.html
@@ -474,6 +474,15 @@ <h3>Method Details</h3>
       &quot;numChildJobs&quot;: &quot;A String&quot;, # [Output-only] Number of child jobs executed.
       &quot;parentJobId&quot;: &quot;A String&quot;, # [Output-only] If this is a child job, the id of the parent.
       &quot;query&quot;: { # [Output-only] Statistics for a query job.
+        &quot;biEngineStatistics&quot;: { # BI Engine specific Statistics. [Output-only] BI Engine specific Statistics.
+          &quot;biEngineMode&quot;: &quot;$(stats.bi_engine_mode)&quot;, # [Output-only] Specifies which mode of BI Engine acceleration was performed (if any).
+          &quot;biEngineReasons&quot;: [ # In case of DISABLED or PARTIAL bi_engine_mode, these contain the explanatory reasons as to why BI Engine could not accelerate. In case the full query was accelerated, this field is not populated.
+            {
+              &quot;code&quot;: &quot;$(reason.code)&quot;, # [Output-only] High-level BI Engine reason for partial or disabled acceleration.
+              &quot;message&quot;: &quot;$(reason.message)&quot;, # [Output-only] Free form human-readable reason for partial or disabled acceleration.
+            },
+          ],
+        },
         &quot;billingTier&quot;: 42, # [Output-only] Billing tier for the job.
         &quot;cacheHit&quot;: True or False, # [Output-only] Whether the query result was fetched from the query cache.
         &quot;ddlAffectedRowAccessPolicyCount&quot;: &quot;A String&quot;, # [Output-only] [Preview] The number of row access policies affected by a DDL statement. Present only for DROP ALL ROW ACCESS POLICIES queries.
@@ -503,7 +512,11 @@ <h3>Method Details</h3>
           &quot;projectId&quot;: &quot;A String&quot;, # [Required] The ID of the project containing this table.
           &quot;tableId&quot;: &quot;A String&quot;, # [Required] The ID of the table. The ID must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_). The maximum length is 1,024 characters.
         },
-        &quot;dmlStats&quot;: &quot;&quot;, # [Output-only] Detailed statistics for DML statements Present only for DML statements INSERT, UPDATE, DELETE or TRUNCATE.
+        &quot;dmlStats&quot;: { # [Output-only] Detailed statistics for DML statements Present only for DML statements INSERT, UPDATE, DELETE or TRUNCATE.
+          &quot;deletedRowCount&quot;: &quot;A String&quot;, # Number of deleted Rows. populated by DML DELETE, MERGE and TRUNCATE statements.
+          &quot;insertedRowCount&quot;: &quot;A String&quot;, # Number of inserted Rows. Populated by DML INSERT and MERGE statements.
+          &quot;updatedRowCount&quot;: &quot;A String&quot;, # Number of updated Rows. Populated by DML UPDATE and MERGE statements.
+        },
         &quot;estimatedBytesProcessed&quot;: &quot;A String&quot;, # [Output-only] The original estimate of bytes processed for the job.
         &quot;modelTraining&quot;: { # [Output-only, Beta] Information about create model query job progress.
           &quot;currentIteration&quot;: 42, # [Output-only, Beta] Index of current ML training iteration. Updated during create model query job to show job progress.
@@ -668,7 +681,7 @@ <h3>Method Details</h3>
           },
         ],
       },
-      &quot;sessionInfoTemplate&quot;: { # [Output-only] [Preview] Information of the session if this job is part of one.
+      &quot;sessionInfo&quot;: { # [Output-only] [Preview] Information of the session if this job is part of one.
         &quot;sessionId&quot;: &quot;A String&quot;, # [Output-only] // [Preview] Id of the session.
       },
       &quot;startTime&quot;: &quot;A String&quot;, # [Output-only] Start time of this job, in milliseconds since the epoch. This field will be present when the job transitions from the PENDING state to either RUNNING or DONE.
@@ -1085,6 +1098,15 @@ <h3>Method Details</h3>
     &quot;numChildJobs&quot;: &quot;A String&quot;, # [Output-only] Number of child jobs executed.
     &quot;parentJobId&quot;: &quot;A String&quot;, # [Output-only] If this is a child job, the id of the parent.
     &quot;query&quot;: { # [Output-only] Statistics for a query job.
+      &quot;biEngineStatistics&quot;: { # BI Engine specific Statistics. [Output-only] BI Engine specific Statistics.
+        &quot;biEngineMode&quot;: &quot;$(stats.bi_engine_mode)&quot;, # [Output-only] Specifies which mode of BI Engine acceleration was performed (if any).
+        &quot;biEngineReasons&quot;: [ # In case of DISABLED or PARTIAL bi_engine_mode, these contain the explanatory reasons as to why BI Engine could not accelerate. In case the full query was accelerated, this field is not populated.
+          {
+            &quot;code&quot;: &quot;$(reason.code)&quot;, # [Output-only] High-level BI Engine reason for partial or disabled acceleration.
+            &quot;message&quot;: &quot;$(reason.message)&quot;, # [Output-only] Free form human-readable reason for partial or disabled acceleration.
+          },
+        ],
+      },
       &quot;billingTier&quot;: 42, # [Output-only] Billing tier for the job.
       &quot;cacheHit&quot;: True or False, # [Output-only] Whether the query result was fetched from the query cache.
       &quot;ddlAffectedRowAccessPolicyCount&quot;: &quot;A String&quot;, # [Output-only] [Preview] The number of row access policies affected by a DDL statement. Present only for DROP ALL ROW ACCESS POLICIES queries.
@@ -1114,7 +1136,11 @@ <h3>Method Details</h3>
         &quot;projectId&quot;: &quot;A String&quot;, # [Required] The ID of the project containing this table.
         &quot;tableId&quot;: &quot;A String&quot;, # [Required] The ID of the table. The ID must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_). The maximum length is 1,024 characters.
       },
-      &quot;dmlStats&quot;: &quot;&quot;, # [Output-only] Detailed statistics for DML statements Present only for DML statements INSERT, UPDATE, DELETE or TRUNCATE.
+      &quot;dmlStats&quot;: { # [Output-only] Detailed statistics for DML statements Present only for DML statements INSERT, UPDATE, DELETE or TRUNCATE.
+        &quot;deletedRowCount&quot;: &quot;A String&quot;, # Number of deleted Rows. populated by DML DELETE, MERGE and TRUNCATE statements.
+        &quot;insertedRowCount&quot;: &quot;A String&quot;, # Number of inserted Rows. Populated by DML INSERT and MERGE statements.
+        &quot;updatedRowCount&quot;: &quot;A String&quot;, # Number of updated Rows. Populated by DML UPDATE and MERGE statements.
+      },
       &quot;estimatedBytesProcessed&quot;: &quot;A String&quot;, # [Output-only] The original estimate of bytes processed for the job.
       &quot;modelTraining&quot;: { # [Output-only, Beta] Information about create model query job progress.
         &quot;currentIteration&quot;: 42, # [Output-only, Beta] Index of current ML training iteration. Updated during create model query job to show job progress.
@@ -1279,7 +1305,7 @@ <h3>Method Details</h3>
         },
       ],
     },
-    &quot;sessionInfoTemplate&quot;: { # [Output-only] [Preview] Information of the session if this job is part of one.
+    &quot;sessionInfo&quot;: { # [Output-only] [Preview] Information of the session if this job is part of one.
       &quot;sessionId&quot;: &quot;A String&quot;, # [Output-only] // [Preview] Id of the session.
     },
     &quot;startTime&quot;: &quot;A String&quot;, # [Output-only] Start time of this job, in milliseconds since the epoch. This field will be present when the job transitions from the PENDING state to either RUNNING or DONE.
@@ -1765,6 +1791,15 @@ <h3>Method Details</h3>
     &quot;numChildJobs&quot;: &quot;A String&quot;, # [Output-only] Number of child jobs executed.
     &quot;parentJobId&quot;: &quot;A String&quot;, # [Output-only] If this is a child job, the id of the parent.
     &quot;query&quot;: { # [Output-only] Statistics for a query job.
+      &quot;biEngineStatistics&quot;: { # BI Engine specific Statistics. [Output-only] BI Engine specific Statistics.
+        &quot;biEngineMode&quot;: &quot;$(stats.bi_engine_mode)&quot;, # [Output-only] Specifies which mode of BI Engine acceleration was performed (if any).
+        &quot;biEngineReasons&quot;: [ # In case of DISABLED or PARTIAL bi_engine_mode, these contain the explanatory reasons as to why BI Engine could not accelerate. In case the full query was accelerated, this field is not populated.
+          {
+            &quot;code&quot;: &quot;$(reason.code)&quot;, # [Output-only] High-level BI Engine reason for partial or disabled acceleration.
+            &quot;message&quot;: &quot;$(reason.message)&quot;, # [Output-only] Free form human-readable reason for partial or disabled acceleration.
+          },
+        ],
+      },
       &quot;billingTier&quot;: 42, # [Output-only] Billing tier for the job.
       &quot;cacheHit&quot;: True or False, # [Output-only] Whether the query result was fetched from the query cache.
       &quot;ddlAffectedRowAccessPolicyCount&quot;: &quot;A String&quot;, # [Output-only] [Preview] The number of row access policies affected by a DDL statement. Present only for DROP ALL ROW ACCESS POLICIES queries.
@@ -1794,7 +1829,11 @@ <h3>Method Details</h3>
         &quot;projectId&quot;: &quot;A String&quot;, # [Required] The ID of the project containing this table.
         &quot;tableId&quot;: &quot;A String&quot;, # [Required] The ID of the table. The ID must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_). The maximum length is 1,024 characters.
       },
-      &quot;dmlStats&quot;: &quot;&quot;, # [Output-only] Detailed statistics for DML statements Present only for DML statements INSERT, UPDATE, DELETE or TRUNCATE.
+      &quot;dmlStats&quot;: { # [Output-only] Detailed statistics for DML statements Present only for DML statements INSERT, UPDATE, DELETE or TRUNCATE.
+        &quot;deletedRowCount&quot;: &quot;A String&quot;, # Number of deleted Rows. populated by DML DELETE, MERGE and TRUNCATE statements.
+        &quot;insertedRowCount&quot;: &quot;A String&quot;, # Number of inserted Rows. Populated by DML INSERT and MERGE statements.
+        &quot;updatedRowCount&quot;: &quot;A String&quot;, # Number of updated Rows. Populated by DML UPDATE and MERGE statements.
+      },
       &quot;estimatedBytesProcessed&quot;: &quot;A String&quot;, # [Output-only] The original estimate of bytes processed for the job.
       &quot;modelTraining&quot;: { # [Output-only, Beta] Information about create model query job progress.
         &quot;currentIteration&quot;: 42, # [Output-only, Beta] Index of current ML training iteration. Updated during create model query job to show job progress.
@@ -1959,7 +1998,7 @@ <h3>Method Details</h3>
         },
       ],
     },
-    &quot;sessionInfoTemplate&quot;: { # [Output-only] [Preview] Information of the session if this job is part of one.
+    &quot;sessionInfo&quot;: { # [Output-only] [Preview] Information of the session if this job is part of one.
       &quot;sessionId&quot;: &quot;A String&quot;, # [Output-only] // [Preview] Id of the session.
     },
     &quot;startTime&quot;: &quot;A String&quot;, # [Output-only] Start time of this job, in milliseconds since the epoch. This field will be present when the job transitions from the PENDING state to either RUNNING or DONE.
@@ -2351,6 +2390,15 @@ <h3>Method Details</h3>
     &quot;numChildJobs&quot;: &quot;A String&quot;, # [Output-only] Number of child jobs executed.
     &quot;parentJobId&quot;: &quot;A String&quot;, # [Output-only] If this is a child job, the id of the parent.
     &quot;query&quot;: { # [Output-only] Statistics for a query job.
+      &quot;biEngineStatistics&quot;: { # BI Engine specific Statistics. [Output-only] BI Engine specific Statistics.
+        &quot;biEngineMode&quot;: &quot;$(stats.bi_engine_mode)&quot;, # [Output-only] Specifies which mode of BI Engine acceleration was performed (if any).
+        &quot;biEngineReasons&quot;: [ # In case of DISABLED or PARTIAL bi_engine_mode, these contain the explanatory reasons as to why BI Engine could not accelerate. In case the full query was accelerated, this field is not populated.
+          {
+            &quot;code&quot;: &quot;$(reason.code)&quot;, # [Output-only] High-level BI Engine reason for partial or disabled acceleration.
+            &quot;message&quot;: &quot;$(reason.message)&quot;, # [Output-only] Free form human-readable reason for partial or disabled acceleration.
+          },
+        ],
+      },
       &quot;billingTier&quot;: 42, # [Output-only] Billing tier for the job.
       &quot;cacheHit&quot;: True or False, # [Output-only] Whether the query result was fetched from the query cache.
       &quot;ddlAffectedRowAccessPolicyCount&quot;: &quot;A String&quot;, # [Output-only] [Preview] The number of row access policies affected by a DDL statement. Present only for DROP ALL ROW ACCESS POLICIES queries.
@@ -2380,7 +2428,11 @@ <h3>Method Details</h3>
         &quot;projectId&quot;: &quot;A String&quot;, # [Required] The ID of the project containing this table.
         &quot;tableId&quot;: &quot;A String&quot;, # [Required] The ID of the table. The ID must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_). The maximum length is 1,024 characters.
       },
-      &quot;dmlStats&quot;: &quot;&quot;, # [Output-only] Detailed statistics for DML statements Present only for DML statements INSERT, UPDATE, DELETE or TRUNCATE.
+      &quot;dmlStats&quot;: { # [Output-only] Detailed statistics for DML statements Present only for DML statements INSERT, UPDATE, DELETE or TRUNCATE.
+        &quot;deletedRowCount&quot;: &quot;A String&quot;, # Number of deleted Rows. populated by DML DELETE, MERGE and TRUNCATE statements.
+        &quot;insertedRowCount&quot;: &quot;A String&quot;, # Number of inserted Rows. Populated by DML INSERT and MERGE statements.
+        &quot;updatedRowCount&quot;: &quot;A String&quot;, # Number of updated Rows. Populated by DML UPDATE and MERGE statements.
+      },
       &quot;estimatedBytesProcessed&quot;: &quot;A String&quot;, # [Output-only] The original estimate of bytes processed for the job.
       &quot;modelTraining&quot;: { # [Output-only, Beta] Information about create model query job progress.
         &quot;currentIteration&quot;: 42, # [Output-only, Beta] Index of current ML training iteration. Updated during create model query job to show job progress.
@@ -2545,7 +2597,7 @@ <h3>Method Details</h3>
         },
       ],
     },
-    &quot;sessionInfoTemplate&quot;: { # [Output-only] [Preview] Information of the session if this job is part of one.
+    &quot;sessionInfo&quot;: { # [Output-only] [Preview] Information of the session if this job is part of one.
       &quot;sessionId&quot;: &quot;A String&quot;, # [Output-only] // [Preview] Id of the session.
     },
     &quot;startTime&quot;: &quot;A String&quot;, # [Output-only] Start time of this job, in milliseconds since the epoch. This field will be present when the job transitions from the PENDING state to either RUNNING or DONE.
@@ -2965,6 +3017,15 @@ <h3>Method Details</h3>
         &quot;numChildJobs&quot;: &quot;A String&quot;, # [Output-only] Number of child jobs executed.
         &quot;parentJobId&quot;: &quot;A String&quot;, # [Output-only] If this is a child job, the id of the parent.
         &quot;query&quot;: { # [Output-only] Statistics for a query job.
+          &quot;biEngineStatistics&quot;: { # BI Engine specific Statistics. [Output-only] BI Engine specific Statistics.
+            &quot;biEngineMode&quot;: &quot;$(stats.bi_engine_mode)&quot;, # [Output-only] Specifies which mode of BI Engine acceleration was performed (if any).
+            &quot;biEngineReasons&quot;: [ # In case of DISABLED or PARTIAL bi_engine_mode, these contain the explanatory reasons as to why BI Engine could not accelerate. In case the full query was accelerated, this field is not populated.
+              {
+                &quot;code&quot;: &quot;$(reason.code)&quot;, # [Output-only] High-level BI Engine reason for partial or disabled acceleration.
+                &quot;message&quot;: &quot;$(reason.message)&quot;, # [Output-only] Free form human-readable reason for partial or disabled acceleration.
+              },
+            ],
+          },
           &quot;billingTier&quot;: 42, # [Output-only] Billing tier for the job.
           &quot;cacheHit&quot;: True or False, # [Output-only] Whether the query result was fetched from the query cache.
           &quot;ddlAffectedRowAccessPolicyCount&quot;: &quot;A String&quot;, # [Output-only] [Preview] The number of row access policies affected by a DDL statement. Present only for DROP ALL ROW ACCESS POLICIES queries.
@@ -2994,7 +3055,11 @@ <h3>Method Details</h3>
             &quot;projectId&quot;: &quot;A String&quot;, # [Required] The ID of the project containing this table.
             &quot;tableId&quot;: &quot;A String&quot;, # [Required] The ID of the table. The ID must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_). The maximum length is 1,024 characters.
           },
-          &quot;dmlStats&quot;: &quot;&quot;, # [Output-only] Detailed statistics for DML statements Present only for DML statements INSERT, UPDATE, DELETE or TRUNCATE.
+          &quot;dmlStats&quot;: { # [Output-only] Detailed statistics for DML statements Present only for DML statements INSERT, UPDATE, DELETE or TRUNCATE.
+            &quot;deletedRowCount&quot;: &quot;A String&quot;, # Number of deleted Rows. populated by DML DELETE, MERGE and TRUNCATE statements.
+            &quot;insertedRowCount&quot;: &quot;A String&quot;, # Number of inserted Rows. Populated by DML INSERT and MERGE statements.
+            &quot;updatedRowCount&quot;: &quot;A String&quot;, # Number of updated Rows. Populated by DML UPDATE and MERGE statements.
+          },
           &quot;estimatedBytesProcessed&quot;: &quot;A String&quot;, # [Output-only] The original estimate of bytes processed for the job.
           &quot;modelTraining&quot;: { # [Output-only, Beta] Information about create model query job progress.
             &quot;currentIteration&quot;: 42, # [Output-only, Beta] Index of current ML training iteration. Updated during create model query job to show job progress.
@@ -3159,7 +3224,7 @@ <h3>Method Details</h3>
             },
           ],
         },
-        &quot;sessionInfoTemplate&quot;: { # [Output-only] [Preview] Information of the session if this job is part of one.
+        &quot;sessionInfo&quot;: { # [Output-only] [Preview] Information of the session if this job is part of one.
           &quot;sessionId&quot;: &quot;A String&quot;, # [Output-only] // [Preview] Id of the session.
         },
         &quot;startTime&quot;: &quot;A String&quot;, # [Output-only] Start time of this job, in milliseconds since the epoch. This field will be present when the job transitions from the PENDING state to either RUNNING or DONE.
@@ -3277,7 +3342,11 @@ <h3>Method Details</h3>
 
     {
   &quot;cacheHit&quot;: True or False, # Whether the query result was fetched from the query cache.
-  &quot;dmlStats&quot;: &quot;&quot;, # [Output-only] Detailed statistics for DML statements Present only for DML statements INSERT, UPDATE, DELETE or TRUNCATE.
+  &quot;dmlStats&quot;: { # [Output-only] Detailed statistics for DML statements Present only for DML statements INSERT, UPDATE, DELETE or TRUNCATE.
+    &quot;deletedRowCount&quot;: &quot;A String&quot;, # Number of deleted Rows. populated by DML DELETE, MERGE and TRUNCATE statements.
+    &quot;insertedRowCount&quot;: &quot;A String&quot;, # Number of inserted Rows. Populated by DML INSERT and MERGE statements.
+    &quot;updatedRowCount&quot;: &quot;A String&quot;, # Number of updated Rows. Populated by DML UPDATE and MERGE statements.
+  },
   &quot;errors&quot;: [ # [Output-only] The first errors or warnings encountered during the running of the job. The final message includes the number of errors that caused the process to stop. Errors here do not necessarily mean that the job has completed or was unsuccessful.
     {
       &quot;debugInfo&quot;: &quot;A String&quot;, # Debugging information. This property is internal to Google and should not be used.