Struct TableService 

pub struct TableService { /* private fields */ }

Implements a client for the BigQuery API.

Example

async fn sample(
) -> anyhow::Result<()> {
    let client = TableService::builder().build().await?;
    let response = client.get_table()
        /* set fields */
        .send().await?;
    println!("response {:?}", response);
    Ok(())
}

Service Description

TableService provides methods for managing BigQuery tables and table-like entities such as views and snapshots.

Configuration

To configure TableService use the with_* methods in the type returned by builder(). The default configuration should work for most applications. Common configuration changes include

• with_endpoint(): by default this client uses the global default endpoint (https://bigquery.googleapis.com). Applications using regional endpoints or running in restricted networks (e.g. a network configured with Private Google Access with VPC Service Controls) may want to override this default.
• with_credentials(): by default this client uses Application Default Credentials. Applications using custom authentication may need to override this default.

Pooling and Cloning

TableService holds a connection pool internally, it is advised to create one and reuse it. You do not need to wrap TableService in an Rc or Arc to reuse it, because it already uses an Arc internally.

Implementations

impl TableService

pub fn builder() -> ClientBuilder

Returns a builder for TableService.

let client = TableService::builder().build().await?;

pub fn from_stub<T>(stub: impl Into<Arc<T>>) -> Self

where T: TableService + 'static,

Creates a new client from the provided stub.

The most common case for calling this function is in tests mocking the client’s behavior.

pub fn get_table(&self) -> GetTable

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.

IAM Permissions

Requires the bigquery.tables.get permission on the table.

Example

use google_cloud_bigquery_v2::Result;
async fn sample(
   client: &TableService
) -> Result<()> {
    let response = client.get_table()
        /* set fields */
        .send().await?;
    println!("response {:?}", response);
    Ok(())
}

pub fn insert_table(&self) -> InsertTable

Creates a new, empty table in the dataset.

IAM Permissions

Requires the bigquery.tables.create permission on the dataset.

Example

use google_cloud_bigquery_v2::Result;
async fn sample(
   client: &TableService
) -> Result<()> {
    let response = client.insert_table()
        /* set fields */
        .send().await?;
    println!("response {:?}", response);
    Ok(())
}

pub fn patch_table(&self) -> PatchTable

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.

IAM Permissions

Requires the following IAM permission(s) on the table:

• bigquery.tables.update
• bigquery.tables.get

Example

use google_cloud_bigquery_v2::Result;
async fn sample(
   client: &TableService
) -> Result<()> {
    let response = client.patch_table()
        /* set fields */
        .send().await?;
    println!("response {:?}", response);
    Ok(())
}

pub fn update_table(&self) -> UpdateTable

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.

IAM Permissions

Requires the bigquery.tables.update permission on the table.

Example

use google_cloud_bigquery_v2::Result;
async fn sample(
   client: &TableService
) -> Result<()> {
    let response = client.update_table()
        /* set fields */
        .send().await?;
    println!("response {:?}", response);
    Ok(())
}

pub fn delete_table(&self) -> DeleteTable

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

IAM Permissions

Requires the bigquery.tables.delete permission on the table.

Example

use google_cloud_bigquery_v2::Result;
async fn sample(
   client: &TableService
) -> Result<()> {
    client.delete_table()
        /* set fields */
        .send().await?;
    Ok(())
}

pub fn list_tables(&self) -> ListTables

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

IAM Permissions

Requires the bigquery.tables.list permission on the dataset.

Example

use google_cloud_gax::paginator::ItemPaginator as _;
use google_cloud_bigquery_v2::Result;
async fn sample(
   client: &TableService
) -> Result<()> {
    let mut list = client.list_tables()
        /* set fields */
        .by_item();
    while let Some(item) = list.next().await.transpose()? {
        println!("{:?}", item);
    }
    Ok(())
}

Trait Implementations

impl Clone for TableService

fn clone(&self) -> TableService

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TableService

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.