- JSON representation
- TableInsertRequest
- Table
- TableName
- TableInfo
- TableViewDefinition
- EncryptionInfo
- TableUpdateRequest
- DatasetListRequest
- DatasetInsertRequest
- Dataset
- DatasetName
- DatasetInfo
- BigQueryAcl
- BigQueryAcl.Entry
- DatasetUpdateRequest
- JobInsertRequest
- Job
- JobName
- JobConfiguration
- JobConfiguration.Query
- TableDefinition
- JobConfiguration.Load
- JobConfiguration.Extract
- JobConfiguration.TableCopy
- JobStatus
- JobStatistics
- JobStatistics.ReservationResourceUsage
- JobQueryRequest
- JobGetQueryResultsRequest
- TableDataListRequest
- SetIamPolicyRequest
- TableInsertResponse
- TableUpdateResponse
- DatasetInsertResponse
- DatasetUpdateResponse
- JobInsertResponse
- JobQueryResponse
- JobGetQueryResultsResponse
- JobQueryDoneResponse
- JobCompletedEvent
- TableDataReadEvent
BigQuery AuditData represents the older AuditData.serviceData log messages.
JSON representation |
---|
{ "jobCompletedEvent": { object ( |
Fields | |
---|---|
job |
A job completion event. |
table |
Information about the table access events. |
Union field request . Request data for each BigQuery method. request can be only one of the following: |
|
table |
Table insert request. |
table |
Table update request. |
dataset |
Dataset list request. |
dataset |
Dataset insert request. |
dataset |
Dataset update request. |
job |
Job insert request. |
job |
Job query request. |
job |
Job get query results request. |
table |
Table data-list request. |
set |
Iam policy request. |
Union field response . Response data for each BigQuery method. response can be only one of the following: |
|
table |
Table insert response. |
table |
Table update response. |
dataset |
Dataset insert response. |
dataset |
Dataset update response. |
job |
Job insert response. |
job |
Job query response. |
job |
Job get query results response. |
job |
Deprecated: Job query-done response. Use this information for usage analysis. |
policy |
Iam Policy. |
TableInsertRequest
Table insert request.
JSON representation |
---|
{
"resource": {
object ( |
Fields | |
---|---|
resource |
The new table. |
Table
Describes a BigQuery table. See the Table API resource for more details on individual fields. Note: Table.schema
has been deprecated in favor of Table.schemaJson
. Table.schema
may continue to be present in your logs during this transition.
JSON representation |
---|
{ "tableName": { object ( |
Fields | |
---|---|
table |
The name of the table. |
info |
User-provided metadata for the table. |
schema |
A JSON representation of the table's schema. |
view |
If present, this is a virtual table defined by a SQL query. |
expire |
The expiration date for the table, after which the table is deleted and the storage reclaimed. If not present, the table persists indefinitely. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
create |
The time the table was created. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
truncate |
The time the table was last truncated by an operation with a A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
update |
The time the table was last modified. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
encryption |
The table encryption information. Set when non-default encryption is used. |
TableName
The fully-qualified name for a table.
JSON representation |
---|
{ "projectId": string, "datasetId": string, "tableId": string } |
Fields | |
---|---|
project |
The project ID. |
dataset |
The dataset ID within the project. |
table |
The table ID of the table within the dataset. |
TableInfo
User-provided metadata for a table.
JSON representation |
---|
{ "friendlyName": string, "description": string, "labels": { string: string, ... } } |
Fields | |
---|---|
friendly |
A short name for the table, such as |
description |
A long description, perhaps several paragraphs, describing the table contents in detail. |
labels |
Labels provided for the table. An object containing a list of |
TableViewDefinition
Describes a virtual table defined by a SQL query.
JSON representation |
---|
{ "query": string } |
Fields | |
---|---|
query |
SQL query defining the view. |
EncryptionInfo
Describes encryption properties for a table or a job
JSON representation |
---|
{ "kmsKeyName": string } |
Fields | |
---|---|
kms |
unique identifier for cloud kms key |
TableUpdateRequest
Table update request.
JSON representation |
---|
{
"resource": {
object ( |
Fields | |
---|---|
resource |
The table to be updated. |
DatasetListRequest
Dataset list request.
JSON representation |
---|
{ "listAll": boolean } |
Fields | |
---|---|
list |
Whether to list all datasets, including hidden ones. |
DatasetInsertRequest
Dataset insert request.
JSON representation |
---|
{
"resource": {
object ( |
Fields | |
---|---|
resource |
The dataset to be inserted. |
Dataset
BigQuery dataset information. See the Dataset API resource for more details on individual fields.
JSON representation |
---|
{ "datasetName": { object ( |
Fields | |
---|---|
dataset |
The name of the dataset. |
info |
User-provided metadata for the dataset. |
create |
The time the dataset was created. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
update |
The time the dataset was last modified. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
acl |
The access control list for the dataset. |
default |
If this field is present, each table that does not specify an expiration time is assigned an expiration time by adding this duration to the table's A duration in seconds with up to nine fractional digits, ending with ' |
DatasetName
The fully-qualified name for a dataset.
JSON representation |
---|
{ "projectId": string, "datasetId": string } |
Fields | |
---|---|
project |
The project ID. |
dataset |
The dataset ID within the project. |
DatasetInfo
User-provided metadata for a dataset.
JSON representation |
---|
{ "friendlyName": string, "description": string, "labels": { string: string, ... } } |
Fields | |
---|---|
friendly |
A short name for the dataset, such as |
description |
A long description, perhaps several paragraphs, describing the dataset contents in detail. |
labels |
Labels provided for the dataset. An object containing a list of |
BigQueryAcl
An access control list.
JSON representation |
---|
{
"entries": [
{
object ( |
Fields | |
---|---|
entries[] |
Access control entry list. |
BigQueryAcl.Entry
Access control entry.
JSON representation |
---|
{
"role": string,
"groupEmail": string,
"userEmail": string,
"domain": string,
"specialGroup": string,
"viewName": {
object ( |
Fields | |
---|---|
role |
The granted role, which can be |
group |
Grants access to a group identified by an email address. |
user |
Grants access to a user identified by an email address. |
domain |
Grants access to all members of a domain. |
special |
Grants access to special groups. Valid groups are |
view |
Grants access to a BigQuery View. |
DatasetUpdateRequest
Dataset update request.
JSON representation |
---|
{
"resource": {
object ( |
Fields | |
---|---|
resource |
The dataset to be updated. |
JobInsertRequest
Job insert request.
JSON representation |
---|
{
"resource": {
object ( |
Fields | |
---|---|
resource |
Job insert request. |
Job
Describes a job.
JSON representation |
---|
{ "jobName": { object ( |
Fields | |
---|---|
job |
Job name. |
job |
Job configuration. |
job |
Job status. |
job |
Job statistics. |
JobName
The fully-qualified name for a job.
JSON representation |
---|
{ "projectId": string, "jobId": string, "location": string } |
Fields | |
---|---|
project |
The project ID. |
job |
The job ID within the project. |
location |
The job location. |
JobConfiguration
Job configuration information. See the Jobs API resource for more details on individual fields.
JSON representation |
---|
{ "dryRun": boolean, "labels": { string: string, ... }, // Union field |
Fields | |
---|---|
dry |
If true, don't actually run the job. Just check that it would run. |
labels |
Labels provided for the job. An object containing a list of |
Union field configuration . Job configuration information. configuration can be only one of the following: |
|
query |
Query job information. |
load |
Load job information. |
extract |
Extract job information. |
table |
TableCopy job information. |
JobConfiguration.Query
Describes a query job, which executes a SQL-like query.
JSON representation |
---|
{ "query": string, "destinationTable": { object ( |
Fields | |
---|---|
query |
The SQL query to run. |
destination |
The table where results are written. |
create |
Describes when a job is allowed to create a table: |
write |
Describes how writes affect existing tables: |
default |
If a table name is specified without a dataset in a query, this dataset will be added to table name. |
table |
Describes data sources outside BigQuery, if needed. |
query |
Describes the priority given to the query: |
destination |
Result table encryption information. Set when non-default encryption is used. |
statement |
Type of the statement (e.g. SELECT, INSERT, CREATE_TABLE, CREATE_MODEL..) |
TableDefinition
Describes an external data source used in a query.
JSON representation |
---|
{ "name": string, "sourceUris": [ string ] } |
Fields | |
---|---|
name |
Name of the table, used in queries. |
source |
Google Cloud Storage URIs for the data to be imported. |
JobConfiguration.Load
Describes a load job, which loads data from an external source via the import pipeline.
JSON representation |
---|
{ "sourceUris": [ string ], "schemaJson": string, "destinationTable": { object ( |
Fields | |
---|---|
source |
URIs for the data to be imported. Only Google Cloud Storage URIs are supported. |
schema |
The table schema in JSON format representation of a TableSchema. |
destination |
The table where the imported data is written. |
create |
Describes when a job is allowed to create a table: |
write |
Describes how writes affect existing tables: |
destination |
Result table encryption information. Set when non-default encryption is used. |
JobConfiguration.Extract
Describes an extract job, which exports data to an external source via the export pipeline.
JSON representation |
---|
{
"destinationUris": [
string
],
"sourceTable": {
object ( |
Fields | |
---|---|
destination |
Google Cloud Storage URIs where extracted data should be written. |
source |
The source table. |
JobConfiguration.TableCopy
Describes a copy job, which copies an existing table to another table.
JSON representation |
---|
{ "sourceTables": [ { object ( |
Fields | |
---|---|
source |
Source tables. |
destination |
Destination table. |
create |
Describes when a job is allowed to create a table: |
write |
Describes how writes affect existing tables: |
destination |
Result table encryption information. Set when non-default encryption is used. |
JobStatus
Running state of a job.
JSON representation |
---|
{ "state": string, "error": { object ( |
Fields | |
---|---|
state |
State of a job: |
error |
If the job did not complete successfully, this field describes why. |
additional |
Errors encountered during the running of the job. Do not necessarily mean that the job has completed or was unsuccessful. |
JobStatistics
Job statistics that may change after a job starts.
JSON representation |
---|
{ "createTime": string, "startTime": string, "endTime": string, "totalProcessedBytes": string, "totalBilledBytes": string, "billingTier": integer, "totalSlotMs": string, "reservationUsage": [ { object ( |
Fields | |
---|---|
create |
Time when the job was created. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
start |
Time when the job started. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
end |
Time when the job ended. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
total |
Total bytes processed for a job. |
total |
Processed bytes, adjusted by the job's CPU usage. |
billing |
The tier assigned by CPU-based billing. |
total |
The total number of slot-ms consumed by the query job. |
reservationUsage[] |
Deprecated as of 12/15/2022. |
reservation |
Reservation name or "unreserved" for on-demand resource usage. |
referenced |
The first N tables accessed by the query job. Older queries that reference a large number of tables may not have all of their tables in this list. You can use the totalTablesProcessed count to know how many total tables were read in the query. For new queries, there is currently no limit. |
total |
Total number of unique tables referenced in the query. |
referenced |
The first N views accessed by the query job. Older queries that reference a large number of views may not have all of their views in this list. You can use the totalTablesProcessed count to know how many total tables were read in the query. For new queries, there is currently no limit. |
total |
Total number of unique views referenced in the query. |
query |
Number of output rows produced by the query job. |
total |
Total bytes loaded for an import job. |
JobStatistics.ReservationResourceUsage
This field is deprecated. Job resource usage breakdown by reservation.
JSON representation |
---|
{ "name": string, "slotMs": string } |
Fields | |
---|---|
name |
Reservation name or "unreserved" for on-demand resources usage. |
slot |
Total slot milliseconds used by the reservation for a particular job. |
JobQueryRequest
Job query request.
JSON representation |
---|
{
"query": string,
"maxResults": integer,
"defaultDataset": {
object ( |
Fields | |
---|---|
query |
The query. |
max |
The maximum number of results. |
default |
The default dataset for tables that do not have a dataset specified. |
project |
Project that the query should be charged to. |
dry |
If true, don't actually run the job. Just check that it would run. |
JobGetQueryResultsRequest
Job getQueryResults request.
JSON representation |
---|
{ "maxResults": integer, "startRow": string } |
Fields | |
---|---|
max |
Maximum number of results to return. |
start |
Zero-based row number at which to start. |
TableDataListRequest
Table data-list request.
JSON representation |
---|
{ "startRow": string, "maxResults": integer } |
Fields | |
---|---|
start |
Starting row offset. |
max |
Maximum number of results to return. |
SetIamPolicyRequest
Request message for SetIamPolicy
method.
JSON representation |
---|
{
"resource": string,
"policy": {
object ( |
Fields | |
---|---|
resource |
REQUIRED: The resource for which the policy is being specified. See Resource names for the appropriate value for this field. |
policy |
REQUIRED: The complete policy to be applied to the |
update |
OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only the fields in the mask will be modified. If no mask is provided, the following default mask is used:
This is a comma-separated list of fully qualified names of fields. Example: |
TableInsertResponse
Table insert response.
JSON representation |
---|
{
"resource": {
object ( |
Fields | |
---|---|
resource |
Final state of the inserted table. |
TableUpdateResponse
Table update response.
JSON representation |
---|
{
"resource": {
object ( |
Fields | |
---|---|
resource |
Final state of the updated table. |
DatasetInsertResponse
Dataset insert response.
JSON representation |
---|
{
"resource": {
object ( |
Fields | |
---|---|
resource |
Final state of the inserted dataset. |
DatasetUpdateResponse
Dataset update response.
JSON representation |
---|
{
"resource": {
object ( |
Fields | |
---|---|
resource |
Final state of the updated dataset. |
JobInsertResponse
Job insert response.
JSON representation |
---|
{
"resource": {
object ( |
Fields | |
---|---|
resource |
Job insert response. |
JobQueryResponse
Job query response.
JSON representation |
---|
{
"totalResults": string,
"job": {
object ( |
Fields | |
---|---|
total |
The total number of rows in the full query result set. |
job |
Information about the queried job. |
JobGetQueryResultsResponse
Job getQueryResults response.
JSON representation |
---|
{
"totalResults": string,
"job": {
object ( |
Fields | |
---|---|
total |
Total number of results in query results. |
job |
The job that was created to run the query. It completed if |
JobQueryDoneResponse
Job getQueryDone response.
JSON representation |
---|
{
"job": {
object ( |
Fields | |
---|---|
job |
The job and status information. The job completed if |
JobCompletedEvent
Query job completed event.
JSON representation |
---|
{
"eventName": string,
"job": {
object ( |
Fields | |
---|---|
event |
Name of the event. |
job |
Job information. |
TableDataReadEvent
Table data read event. Only present for tables, not views, and is only included in the log record for the project that owns the table.
JSON representation |
---|
{
"tableName": {
object ( |
Fields | |
---|---|
table |
Name of the accessed table. |
referenced |
A list of referenced fields. This information is not included by default. To enable this in the logs, please contact BigQuery support or open a bug in the BigQuery issue tracker. |