Struct gcp_bigquery_client::table::TableApi

pub struct TableApi { /* fields omitted */ }

A table API handler.

Implementations

impl TableApi

pub async fn create(
    &self,
    project_id: &str,
    dataset_id: &str,
    table: Table
) -> Result<Table, BQError>

Creates a new, empty table in the dataset.

Arguments

• project_id - Project ID of the table to delete
• dataset_id - Dataset ID of the table to delete
• table - The request body contains an instance of Table.

pub async fn delete(
    &self,
    project_id: &str,
    dataset_id: &str,
    table_id: &str
) -> Result<(), BQError>

Deletes the table specified by tableId from the dataset. If the table contains data, all the data will be deleted.

Arguments

• project_id - Project ID of the table to delete
• dataset_id - Dataset ID of the table to delete
• table_id - Table ID of the table to delete

pub async fn get(
    &self,
    project_id: &str,
    dataset_id: &str,
    table_id: &str,
    selected_fields: Option<Vec<&str>>
) -> Result<Table, BQError>

Gets the specified table resource by table ID. This method does not return the data in the table, it only returns the table resource, which describes the structure of this table.

Arguments

• project_id - Project ID of the table to delete
• dataset_id - Dataset ID of the table to delete
• table_id - Table ID of the table to delete
• selected_fields - tabledata.list of table schema fields to return (comma-separated). If unspecified, all fields are returned. A fieldMask cannot be used here because the fields will automatically be converted from camelCase to snake_case and the conversion will fail if there are underscores. Since these are fields in BigQuery table schemas, underscores are allowed.

pub async fn list(
    &self,
    project_id: &str,
    dataset_id: &str,
    options: ListOptions
) -> Result<TableList, BQError>

Lists all tables in the specified dataset. Requires the READER dataset role.

Arguments

• project_id - Project ID of the table to delete
• dataset_id - Dataset ID of the table to delete
• options - Options

pub async fn patch(
    &self,
    project_id: &str,
    dataset_id: &str,
    table_id: &str,
    table: Table
) -> Result<Table, BQError>

Updates information in an existing table. The update method replaces the entire table resource, whereas the patch method only replaces fields that are provided in the submitted table resource. This method supports RFC5789 patch semantics.

Arguments

• project_id - Project ID of the table to delete
• dataset_id - Dataset ID of the table to delete
• table_id - Table ID of the table to delete
• table - Table to patch

pub async fn update(
    &self,
    project_id: &str,
    dataset_id: &str,
    table_id: &str,
    table: Table
) -> Result<Table, BQError>

Updates information in an existing table. The update method replaces the entire Table resource, whereas the patch method only replaces fields that are provided in the submitted Table resource.

Arguments

• project_id - Project ID of the table to delete
• dataset_id - Dataset ID of the table to delete
• table_id - Table ID of the table to delete
• table - Table to update

pub async fn get_iam_policy(
    &self,
    resource: &str,
    get_iam_policy_request: GetIamPolicyRequest
) -> Result<Policy, BQError>

Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.

Argument

• resource - The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field.

pub async fn set_iam_policy(
    &self,
    resource: &str,
    set_iam_policy_request: SetIamPolicyRequest
) -> Result<Policy, BQError>

Sets the access control policy on the specified resource. Replaces any existing policy. Can return NOT_FOUND, INVALID_ARGUMENT, and PERMISSION_DENIED errors.

Argument

• resource - The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field.

pub async fn test_iam_permissions(
    &self,
    resource: &str,
    test_iam_permissions_request: TestIamPermissionsRequest
) -> Result<TestIamPermissionsResponse, BQError>

Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a NOT_FOUND error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may "fail open" without warning.

Argument

• resource - The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field.