alicloud_ots_table

更新时间:

Provides an OTS table resource.

-> NOTE: From Provider version 1.10.0, the provider field 'ots_instance_name' has been deprecated and you should use resource alicloud_ots_table's new field 'instance_name' and 'table_name' to re-import this resource.

-> NOTE: Available since v1.9.2.

Example Usage


variable "name" {
  default = "tf-example"
}

resource "random_integer" "default" {
  min = 10000
  max = 99999
}

resource "alicloud_ots_instance" "default" {
  name        = "${var.name}-${random_integer.default.result}"
  description = var.name
  accessed_by = "Any"
  tags = {
    Created = "TF",
    For     = "example",
  }
}

resource "alicloud_ots_table" "default" {
  instance_name = alicloud_ots_instance.default.name
  table_name    = "tf_example"
  time_to_live  = -1
  max_version   = 1
  enable_sse    = true
  sse_key_type  = "SSE_KMS_SERVICE"
  primary_key {
    name = "pk1"
    type = "Integer"
  }
  primary_key {
    name = "pk2"
    type = "String"
  }
  primary_key {
    name = "pk3"
    type = "Binary"
  }

  defined_column {
    name = "col1"
    type = "Integer"
  }
  defined_column {
    name = "col2"
    type = "String"
  }
  defined_column {
    name = "col3"
    type = "Binary"
  }
}

Argument Reference

The following arguments are supported:

  • instance_name - (Required, ForceNew) The name of the OTS instance in which table will located.
  • table_name - (Required, ForceNew) The table name of the OTS instance. If changed, a new table would be created.
  • primary_key - (Required, ForceNew) The property of TableMeta which indicates the structure information of a table. It describes the attribute value of primary key. The number of primary_key should not be less than one and not be more than four. See primary_key below.
  • defined_column - (Optional, Available since v1.187.0) The property of TableMeta which indicates the structure information of a table. It describes the attribute value of defined column. The number of defined_column should not be more than 32. See defined_column below.
  • time_to_live - (Required) The retention time of data stored in this table (unit: second). The value maximum is 2147483647 and -1 means never expired.
  • max_version - (Required) The maximum number of versions stored in this table. The valid value is 1-2147483647.
  • allow_update - (Optional, Available since v1.224.0) Whether allow data update operations. Default value is true. Skipping the resource state refresh step may result in unnecessary execution plan when upgrading from an earlier version.
  • deviation_cell_version_in_sec - (Optional, Available in 1.42.0+) The max version offset of the table. The valid value is 1-9223372036854775807. Defaults to 86400.
  • enable_sse - (Optional, Available since v1.172.0) Whether enable OTS server side encryption. Default value is false.
  • sse_key_type - (Optional, Available since v1.172.0) The key type of OTS server side encryption. SSE_KMS_SERVICE, SSE_BYOK is allowed.
  • sse_key_id - (Optional, Available since v1.224.0) . The key ID of secret. sse_key_id is valid only when sse_key_type is set to SSE_BYOK.
  • sse_role_arn - (Optional, Available since v1.224.0) The arn of role that can access kms service. sse_role_arn is valid only when sse_key_type is set to SSE_BYOK.

defined_column

The defined_column supports the following:

  • name - (Required, Available since v1.187.0) Name for defined column.
  • type - (Required, Available since v1.187.0) Type for defined column. Integer, String, Binary, Double, Boolean is allowed.

primary_key

The primary_key supports the following:

  • name - (Required, ForceNew) Name for primary key.
  • type - (Required, ForceNew) Type for primary key. Only Integer, String or Binary is allowed.

Attributes Reference

The following attributes are exported:

  • id - The resource ID. The value is <instance_name>:<table_name>.

Import

OTS table can be imported using id, e.g.

$ terraform import alicloud_ots_table.table my-ots:ots_table