awswrangler.timestream.create_database

awswrangler.timestream.create_database(database: str, kms_key_id: str | None = None, tags: dict[str, str] | None = None, boto3_session: Session | None = None) → str

Create a new Timestream database.

Note

If the KMS key is not specified, the database will be encrypted with a Timestream managed KMS key located in your account.

Parameters:

  • database (str) – Database name.

  • kms_key_id (str | None) – The KMS key for the database. If the KMS key is not specified, the database will be encrypted with a Timestream managed KMS key located in your account.

  • tags (dict[str, str] | None) – Key/Value dict to put on the database. Tags enable you to categorize databases and/or tables, for example, by purpose, owner, or environment. e.g. {“foo”: “boo”, “bar”: “xoo”})

  • boto3_session (Session | None) – The default boto3 session will be used if boto3_session is None.

Return type:

str

Returns:

The Amazon Resource Name that uniquely identifies this database. (ARN)

Examples

Creating a database.

>>> import awswrangler as wr
>>> arn = wr.timestream.create_database("MyDatabase")