Skip to content

TimestreamQueryClient#

Index > TimestreamQuery > TimestreamQueryClient

Auto-generated documentation for TimestreamQuery type annotations stubs module types-boto3-timestream-query.

TimestreamQueryClient#

Type annotations and code completion for boto3.client("timestream-query"). boto3 documentation

# TimestreamQueryClient usage example

from boto3.session import Session
from types_boto3_timestream_query.client import TimestreamQueryClient

def get_timestream-query_client() -> TimestreamQueryClient:
    return Session().client("timestream-query")

Exceptions#

boto3 client exceptions are generated in runtime. This class provides code completion for boto3.client("timestream-query").exceptions structure.

# Exceptions.exceptions usage example

client = boto3.client("timestream-query")

try:
    do_something(client)
except (
    client.exceptions.AccessDeniedException,
    client.exceptions.ClientError,
    client.exceptions.ConflictException,
    client.exceptions.InternalServerException,
    client.exceptions.InvalidEndpointException,
    client.exceptions.QueryExecutionException,
    client.exceptions.ResourceNotFoundException,
    client.exceptions.ServiceQuotaExceededException,
    client.exceptions.ThrottlingException,
    client.exceptions.ValidationException,
) as e:
    print(e)
# Exceptions.exceptions type checking example

from types_boto3_timestream_query.client import Exceptions

def handle_error(exc: Exceptions.AccessDeniedException) -> None:
    ...

Methods#

can_paginate#

Type annotations and code completion for boto3.client("timestream-query").can_paginate method. boto3 documentation

# can_paginate method definition

def can_paginate(
    self,
    operation_name: str,
) -> bool:
    ...

generate_presigned_url#

Type annotations and code completion for boto3.client("timestream-query").generate_presigned_url method. boto3 documentation

# generate_presigned_url method definition

def generate_presigned_url(
    self,
    ClientMethod: str,
    Params: Mapping[str, Any] = ...,
    ExpiresIn: int = 3600,
    HttpMethod: str = ...,
) -> str:
    ...

cancel_query#

Cancels a query that has been issued.

Type annotations and code completion for boto3.client("timestream-query").cancel_query method. boto3 documentation

# cancel_query method definition

def cancel_query(
    self,
    *,
    QueryId: str,
) -> CancelQueryResponseTypeDef:  # (1)
    ...
  1. See CancelQueryResponseTypeDef 
# cancel_query method usage example with argument unpacking

kwargs: CancelQueryRequestRequestTypeDef = {  # (1)
    "QueryId": ...,
}

parent.cancel_query(**kwargs)
  1. See CancelQueryRequestRequestTypeDef

create_scheduled_query#

Create a scheduled query that will be run on your behalf at the configured schedule.

Type annotations and code completion for boto3.client("timestream-query").create_scheduled_query method. boto3 documentation

# create_scheduled_query method definition

def create_scheduled_query(
    self,
    *,
    Name: str,
    QueryString: str,
    ScheduleConfiguration: ScheduleConfigurationTypeDef,  # (1)
    NotificationConfiguration: NotificationConfigurationTypeDef,  # (2)
    ScheduledQueryExecutionRoleArn: str,
    ErrorReportConfiguration: ErrorReportConfigurationTypeDef,  # (3)
    TargetConfiguration: TargetConfigurationTypeDef = ...,  # (4)
    ClientToken: str = ...,
    Tags: Sequence[TagTypeDef] = ...,  # (5)
    KmsKeyId: str = ...,
) -> CreateScheduledQueryResponseTypeDef:  # (6)
    ...
  1. See ScheduleConfigurationTypeDef
  2. See NotificationConfigurationTypeDef
  3. See ErrorReportConfigurationTypeDef
  4. See TargetConfigurationTypeDef
  5. See TagTypeDef
  6. See CreateScheduledQueryResponseTypeDef 
# create_scheduled_query method usage example with argument unpacking

kwargs: CreateScheduledQueryRequestRequestTypeDef = {  # (1)
    "Name": ...,
    "QueryString": ...,
    "ScheduleConfiguration": ...,
    "NotificationConfiguration": ...,
    "ScheduledQueryExecutionRoleArn": ...,
    "ErrorReportConfiguration": ...,
}

parent.create_scheduled_query(**kwargs)
  1. See CreateScheduledQueryRequestRequestTypeDef

delete_scheduled_query#

Deletes a given scheduled query.

Type annotations and code completion for boto3.client("timestream-query").delete_scheduled_query method. boto3 documentation

# delete_scheduled_query method definition

def delete_scheduled_query(
    self,
    *,
    ScheduledQueryArn: str,
) -> EmptyResponseMetadataTypeDef:  # (1)
    ...
  1. See EmptyResponseMetadataTypeDef 
# delete_scheduled_query method usage example with argument unpacking

kwargs: DeleteScheduledQueryRequestRequestTypeDef = {  # (1)
    "ScheduledQueryArn": ...,
}

parent.delete_scheduled_query(**kwargs)
  1. See DeleteScheduledQueryRequestRequestTypeDef

describe_account_settings#

Describes the settings for your account that include the query pricing model and the configured maximum TCUs the service can use for your query workload.

Type annotations and code completion for boto3.client("timestream-query").describe_account_settings method. boto3 documentation

# describe_account_settings method definition

def describe_account_settings(
    self,
) -> DescribeAccountSettingsResponseTypeDef:  # (1)
    ...
  1. See DescribeAccountSettingsResponseTypeDef

describe_endpoints#

DescribeEndpoints returns a list of available endpoints to make Timestream API calls against.

Type annotations and code completion for boto3.client("timestream-query").describe_endpoints method. boto3 documentation

# describe_endpoints method definition

def describe_endpoints(
    self,
) -> DescribeEndpointsResponseTypeDef:  # (1)
    ...
  1. See DescribeEndpointsResponseTypeDef

describe_scheduled_query#

Provides detailed information about a scheduled query.

Type annotations and code completion for boto3.client("timestream-query").describe_scheduled_query method. boto3 documentation

# describe_scheduled_query method definition

def describe_scheduled_query(
    self,
    *,
    ScheduledQueryArn: str,
) -> DescribeScheduledQueryResponseTypeDef:  # (1)
    ...
  1. See DescribeScheduledQueryResponseTypeDef 
# describe_scheduled_query method usage example with argument unpacking

kwargs: DescribeScheduledQueryRequestRequestTypeDef = {  # (1)
    "ScheduledQueryArn": ...,
}

parent.describe_scheduled_query(**kwargs)
  1. See DescribeScheduledQueryRequestRequestTypeDef

execute_scheduled_query#

You can use this API to run a scheduled query manually.

Type annotations and code completion for boto3.client("timestream-query").execute_scheduled_query method. boto3 documentation

# execute_scheduled_query method definition

def execute_scheduled_query(
    self,
    *,
    ScheduledQueryArn: str,
    InvocationTime: TimestampTypeDef,
    ClientToken: str = ...,
    QueryInsights: ScheduledQueryInsightsTypeDef = ...,  # (1)
) -> EmptyResponseMetadataTypeDef:  # (2)
    ...
  1. See ScheduledQueryInsightsTypeDef
  2. See EmptyResponseMetadataTypeDef 
# execute_scheduled_query method usage example with argument unpacking

kwargs: ExecuteScheduledQueryRequestRequestTypeDef = {  # (1)
    "ScheduledQueryArn": ...,
    "InvocationTime": ...,
}

parent.execute_scheduled_query(**kwargs)
  1. See ExecuteScheduledQueryRequestRequestTypeDef

list_scheduled_queries#

Gets a list of all scheduled queries in the caller's Amazon account and Region.

Type annotations and code completion for boto3.client("timestream-query").list_scheduled_queries method. boto3 documentation

# list_scheduled_queries method definition

def list_scheduled_queries(
    self,
    *,
    MaxResults: int = ...,
    NextToken: str = ...,
) -> ListScheduledQueriesResponseTypeDef:  # (1)
    ...
  1. See ListScheduledQueriesResponseTypeDef 
# list_scheduled_queries method usage example with argument unpacking

kwargs: ListScheduledQueriesRequestRequestTypeDef = {  # (1)
    "MaxResults": ...,
}

parent.list_scheduled_queries(**kwargs)
  1. See ListScheduledQueriesRequestRequestTypeDef

list_tags_for_resource#

List all tags on a Timestream query resource.

Type annotations and code completion for boto3.client("timestream-query").list_tags_for_resource method. boto3 documentation

# list_tags_for_resource method definition

def list_tags_for_resource(
    self,
    *,
    ResourceARN: str,
    MaxResults: int = ...,
    NextToken: str = ...,
) -> ListTagsForResourceResponseTypeDef:  # (1)
    ...
  1. See ListTagsForResourceResponseTypeDef 
# list_tags_for_resource method usage example with argument unpacking

kwargs: ListTagsForResourceRequestRequestTypeDef = {  # (1)
    "ResourceARN": ...,
}

parent.list_tags_for_resource(**kwargs)
  1. See ListTagsForResourceRequestRequestTypeDef

prepare_query#

A synchronous operation that allows you to submit a query with parameters to be stored by Timestream for later running.

Type annotations and code completion for boto3.client("timestream-query").prepare_query method. boto3 documentation

# prepare_query method definition

def prepare_query(
    self,
    *,
    QueryString: str,
    ValidateOnly: bool = ...,
) -> PrepareQueryResponseTypeDef:  # (1)
    ...
  1. See PrepareQueryResponseTypeDef 
# prepare_query method usage example with argument unpacking

kwargs: PrepareQueryRequestRequestTypeDef = {  # (1)
    "QueryString": ...,
}

parent.prepare_query(**kwargs)
  1. See PrepareQueryRequestRequestTypeDef

query#

Query is a synchronous operation that enables you to run a query against your Amazon Timestream data.

Type annotations and code completion for boto3.client("timestream-query").query method. boto3 documentation

# query method definition

def query(
    self,
    *,
    QueryString: str,
    ClientToken: str = ...,
    NextToken: str = ...,
    MaxRows: int = ...,
    QueryInsights: QueryInsightsTypeDef = ...,  # (1)
) -> QueryResponseTypeDef:  # (2)
    ...
  1. See QueryInsightsTypeDef
  2. See QueryResponseTypeDef 
# query method usage example with argument unpacking

kwargs: QueryRequestRequestTypeDef = {  # (1)
    "QueryString": ...,
}

parent.query(**kwargs)
  1. See QueryRequestRequestTypeDef

tag_resource#

Associate a set of tags with a Timestream resource.

Type annotations and code completion for boto3.client("timestream-query").tag_resource method. boto3 documentation

# tag_resource method definition

def tag_resource(
    self,
    *,
    ResourceARN: str,
    Tags: Sequence[TagTypeDef],  # (1)
) -> dict[str, Any]:
    ...
  1. See TagTypeDef 
# tag_resource method usage example with argument unpacking

kwargs: TagResourceRequestRequestTypeDef = {  # (1)
    "ResourceARN": ...,
    "Tags": ...,
}

parent.tag_resource(**kwargs)
  1. See TagResourceRequestRequestTypeDef

untag_resource#

Removes the association of tags from a Timestream query resource.

Type annotations and code completion for boto3.client("timestream-query").untag_resource method. boto3 documentation

# untag_resource method definition

def untag_resource(
    self,
    *,
    ResourceARN: str,
    TagKeys: Sequence[str],
) -> dict[str, Any]:
    ...
# untag_resource method usage example with argument unpacking

kwargs: UntagResourceRequestRequestTypeDef = {  # (1)
    "ResourceARN": ...,
    "TagKeys": ...,
}

parent.untag_resource(**kwargs)
  1. See UntagResourceRequestRequestTypeDef

update_account_settings#

Transitions your account to use TCUs for query pricing and modifies the maximum query compute units that you've configured.

Type annotations and code completion for boto3.client("timestream-query").update_account_settings method. boto3 documentation

# update_account_settings method definition

def update_account_settings(
    self,
    *,
    MaxQueryTCU: int = ...,
    QueryPricingModel: QueryPricingModelType = ...,  # (1)
    QueryCompute: QueryComputeRequestTypeDef = ...,  # (2)
) -> UpdateAccountSettingsResponseTypeDef:  # (3)
    ...
  1. See QueryPricingModelType
  2. See QueryComputeRequestTypeDef
  3. See UpdateAccountSettingsResponseTypeDef 
# update_account_settings method usage example with argument unpacking

kwargs: UpdateAccountSettingsRequestRequestTypeDef = {  # (1)
    "MaxQueryTCU": ...,
}

parent.update_account_settings(**kwargs)
  1. See UpdateAccountSettingsRequestRequestTypeDef

update_scheduled_query#

Update a scheduled query.

Type annotations and code completion for boto3.client("timestream-query").update_scheduled_query method. boto3 documentation

# update_scheduled_query method definition

def update_scheduled_query(
    self,
    *,
    ScheduledQueryArn: str,
    State: ScheduledQueryStateType,  # (1)
) -> EmptyResponseMetadataTypeDef:  # (2)
    ...
  1. See ScheduledQueryStateType
  2. See EmptyResponseMetadataTypeDef 
# update_scheduled_query method usage example with argument unpacking

kwargs: UpdateScheduledQueryRequestRequestTypeDef = {  # (1)
    "ScheduledQueryArn": ...,
    "State": ...,
}

parent.update_scheduled_query(**kwargs)
  1. See UpdateScheduledQueryRequestRequestTypeDef

get_paginator#

Type annotations and code completion for boto3.client("timestream-query").get_paginator method with overloads.