Struct Table

#[non_exhaustive]
pub struct Table {

    pub name: String,
    pub database_name: Option<String>,
    pub description: Option<String>,
    pub owner: Option<String>,
    pub create_time: Option<DateTime>,
    pub update_time: Option<DateTime>,
    pub last_access_time: Option<DateTime>,
    pub last_analyzed_time: Option<DateTime>,
    pub retention: i32,
    pub storage_descriptor: Option<StorageDescriptor>,
    pub partition_keys: Option<Vec<Column>>,
    pub view_original_text: Option<String>,
    pub view_expanded_text: Option<String>,
    pub table_type: Option<String>,
    pub parameters: Option<HashMap<String, String>>,
    pub created_by: Option<String>,
    pub is_registered_with_lake_formation: bool,
    pub target_table: Option<TableIdentifier>,
    pub catalog_id: Option<String>,
    pub version_id: Option<String>,
    pub federated_table: Option<FederatedTable>,
    pub view_definition: Option<ViewDefinition>,
    pub is_multi_dialect_view: Option<bool>,
    pub status: Option<TableStatus>,
}

Represents a collection of related data organized in columns and rows.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

name: String

The table name. For Hive compatibility, this must be entirely lowercase.

database_name: Option<String>

The name of the database where the table metadata resides. For Hive compatibility, this must be all lowercase.

description: Option<String>

A description of the table.

owner: Option<String>

The owner of the table.

create_time: Option<DateTime>

The time when the table definition was created in the Data Catalog.

update_time: Option<DateTime>

The last time that the table was updated.

last_access_time: Option<DateTime>

The last time that the table was accessed. This is usually taken from HDFS, and might not be reliable.

last_analyzed_time: Option<DateTime>

The last time that column statistics were computed for this table.

retention: i32

The retention time for this table.

storage_descriptor: Option<StorageDescriptor>

A storage descriptor containing information about the physical storage of this table.

partition_keys: Option<Vec<Column>>

A list of columns by which the table is partitioned. Only primitive types are supported as partition keys.

When you create a table used by Amazon Athena, and you do not specify any partitionKeys, you must at least set the value of partitionKeys to an empty list. For example:

"PartitionKeys": \[\]

view_original_text: Option<String>

Included for Apache Hive compatibility. Not used in the normal course of Glue operations. If the table is a VIRTUAL_VIEW, certain Athena configuration encoded in base64.

view_expanded_text: Option<String>

Included for Apache Hive compatibility. Not used in the normal course of Glue operations.

table_type: Option<String>

The type of this table. Glue will create tables with the EXTERNAL_TABLE type. Other services, such as Athena, may create tables with additional table types.

Glue related table types:

EXTERNAL_TABLE

Hive compatible attribute - indicates a non-Hive managed table.

GOVERNED

Used by Lake Formation. The Glue Data Catalog understands GOVERNED.

parameters: Option<HashMap<String, String>>

These key-value pairs define properties associated with the table.

created_by: Option<String>

The person or entity who created the table.

is_registered_with_lake_formation: bool

Indicates whether the table has been registered with Lake Formation.

target_table: Option<TableIdentifier>

A TableIdentifier structure that describes a target table for resource linking.

catalog_id: Option<String>

The ID of the Data Catalog in which the table resides.

version_id: Option<String>

The ID of the table version.

federated_table: Option<FederatedTable>

A FederatedTable structure that references an entity outside the Glue Data Catalog.

view_definition: Option<ViewDefinition>

A structure that contains all the information that defines the view, including the dialect or dialects for the view, and the query.

is_multi_dialect_view: Option<bool>

Specifies whether the view supports the SQL dialects of one or more different query engines and can therefore be read by those engines.

status: Option<TableStatus>

A structure containing information about the state of an asynchronous change to a table.

Implementations

impl Table

pub fn name(&self) -> &str

The table name. For Hive compatibility, this must be entirely lowercase.

pub fn database_name(&self) -> Option<&str>

The name of the database where the table metadata resides. For Hive compatibility, this must be all lowercase.

pub fn description(&self) -> Option<&str>

A description of the table.

pub fn owner(&self) -> Option<&str>

The owner of the table.

pub fn create_time(&self) -> Option<&DateTime>

The time when the table definition was created in the Data Catalog.

pub fn update_time(&self) -> Option<&DateTime>

The last time that the table was updated.

pub fn last_access_time(&self) -> Option<&DateTime>

The last time that the table was accessed. This is usually taken from HDFS, and might not be reliable.

pub fn last_analyzed_time(&self) -> Option<&DateTime>

The last time that column statistics were computed for this table.

pub fn retention(&self) -> i32

The retention time for this table.

pub fn storage_descriptor(&self) -> Option<&StorageDescriptor>

A storage descriptor containing information about the physical storage of this table.

pub fn partition_keys(&self) -> &[Column]

A list of columns by which the table is partitioned. Only primitive types are supported as partition keys.

When you create a table used by Amazon Athena, and you do not specify any partitionKeys, you must at least set the value of partitionKeys to an empty list. For example:

"PartitionKeys": \[\]

If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .partition_keys.is_none().

pub fn view_original_text(&self) -> Option<&str>

Included for Apache Hive compatibility. Not used in the normal course of Glue operations. If the table is a VIRTUAL_VIEW, certain Athena configuration encoded in base64.

pub fn view_expanded_text(&self) -> Option<&str>

Included for Apache Hive compatibility. Not used in the normal course of Glue operations.

pub fn table_type(&self) -> Option<&str>

The type of this table. Glue will create tables with the EXTERNAL_TABLE type. Other services, such as Athena, may create tables with additional table types.

Glue related table types:

EXTERNAL_TABLE

Hive compatible attribute - indicates a non-Hive managed table.

GOVERNED

Used by Lake Formation. The Glue Data Catalog understands GOVERNED.

pub fn parameters(&self) -> Option<&HashMap<String, String>>

These key-value pairs define properties associated with the table.

pub fn created_by(&self) -> Option<&str>

The person or entity who created the table.

pub fn is_registered_with_lake_formation(&self) -> bool

Indicates whether the table has been registered with Lake Formation.

pub fn target_table(&self) -> Option<&TableIdentifier>

A TableIdentifier structure that describes a target table for resource linking.

pub fn catalog_id(&self) -> Option<&str>

The ID of the Data Catalog in which the table resides.

pub fn version_id(&self) -> Option<&str>

The ID of the table version.

pub fn federated_table(&self) -> Option<&FederatedTable>

A FederatedTable structure that references an entity outside the Glue Data Catalog.

pub fn view_definition(&self) -> Option<&ViewDefinition>

A structure that contains all the information that defines the view, including the dialect or dialects for the view, and the query.

pub fn is_multi_dialect_view(&self) -> Option<bool>

Specifies whether the view supports the SQL dialects of one or more different query engines and can therefore be read by those engines.

pub fn status(&self) -> Option<&TableStatus>

A structure containing information about the state of an asynchronous change to a table.

impl Table

pub fn builder() -> TableBuilder

Creates a new builder-style object to manufacture Table.

Trait Implementations

impl Clone for Table

fn clone(&self) -> Table

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Table

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

Formats the value using the given formatter.

impl PartialEq for Table

fn eq(&self, other: &Table) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for Table