S3 Storage Engine System Variables

MariaDB starting with 10.5

S3 is introduced in MariaDB 10.5.

This page documents system variables related to the S3 storage engine.

See Server System Variables for a complete list of system variables and instructions on setting system variables.

Also see the Full list of MariaDB options, system and status variables

s3_access_key


s3_block_size


s3_bucket

  • Description: The AWS bucket where your data should be stored. All MariaDB table data is stored in this bucket. See mysqld startup options for S3.
  • Commandline: --s3-bucket=val
  • Scope:
  • Dynamic:
  • Data Type:
  • Default Value:
  • Introduced: MariaDB 10.5.0

s3_debug

  • Description: Generates a trace file from libmarias3 on stderr (mysqld.err) for debugging the S3 protocol.
  • Commandline: --s3-debug{=0|1}
  • Scope:
  • Dynamic: No
  • Data Type: Boolean
  • Valid Values: 0 or 1
  • Default Value: 0
  • Introduced: MariaDB 10.5.0

s3_host_name

  • Description: Hostname for the S3 service. "s3.amazonaws.com", Amazon S3 service, by default
  • Commandline: --s3-host-name=val
  • Scope:
  • Dynamic:
  • Data Type:
  • Default Value: "s3.amazonaws.com"
  • Introduced: MariaDB 10.5.0

s3_pagecache_age_threshold

  • Description: This characterizes the number of hits a hot block has to be untouched until it is considered aged enough to be downgraded to a warm block. This specifies the percentage ratio of that number of hits to the total number of blocks in the page cache.
  • Commandline: --s3-pagecache-age-threshold=val
  • Scope:
  • Dynamic: Yes
  • Data Type: Numeric
  • Default Value: 300
  • Introduced: MariaDB 10.5.0

s3_pagecache_buffer_size

  • Description: The size of the buffer used for index blocks for S3 tables. Increase this to get better index handling (for all reads and multiple writes) to as much as you can afford.
  • Commandline: --s3-pagecache-buffer-size=val
  • Scope:
  • Dynamic: No
  • Data Type: Numeric
  • Default Value: 128M
  • Introduced: MariaDB 10.5.0

s3_pagecache_division_limit

  • Description: The minimum percentage of warm blocks in key cache.
  • Commandline: --s3-pagecache-division-limit=val
  • Scope:
  • Dynamic:
  • Data Type: Numeric
  • Default Value: 100
  • Introduced: MariaDB 10.5.0

s3_pagecache_file_hash_size

  • Description: Number of hash buckets for open files. Default 512. If you have a lot of S3 files open you should increase this for faster flush of changes. A good value is probably 1/10 of number of possible open S3 files.
  • Commandline: --s3-pagecache-file-hash-size=#
  • Scope:
  • Dynamic:
  • Data Type: Numeric
  • Default Value: 512
  • Introduced: MariaDB 10.5.0

s3_protocol_version

  • Description: Protocol used to communication with S3. One of "Auto", "Amazon" or "Original" where "Auto" is the default. If you get errors like "8 Access Denied" when you are connecting to another service provider, then try to change this option. The reason for this variable is that Amazon has changed some parts of the S3 protocol since they originally introduced it but other service providers are still using the original protocol.
  • Commandline: --s3-protocol-version=val
  • Scope:
  • Dynamic:
  • Data Type: Enum
  • Valid Values: Auto, Amazon or Original
  • Default Value: "Amazon"
  • Introduced: MariaDB 10.5.0

s3_region


s3_secret_key


Comments

Comments loading...