On this page

    Amazon OpenSearch Service

    If you are using Elasticsearch standalone (not on AWS), see Elasticsearch.


    Dremio support the following versions:

    • Amazon OpenSearch Service (version 5.x, 6.0, 6.2, 6.3, 7.0+).

    Dremio Configuration



    HostAWS OpenSearch Host name.
    PortPort on which the AWS OpenSearch service is running (usually 443).


    • AWS Access Key method – Used for key-based authentication.
      • AWS Access Key – AWS access key
      • AWS Access Secret – AWS access secret.
    • EC2 Metadata method – Dremio uses IAM policy from EC2 instance
    • AWS Profile – Dremio sources profile credentials from the specified AWS profile. For information on how to set up a configuration or credentials file for AWS, see AWS Custom Authentication.
      • Profile Name (Optional) – The AWS profile name. If this is left blank, then the default profile will be used. For more information about using profiles in a credentials or configuration file, see AWS’s documentation on Configuration and credential file settings.
    • No Authentication – No Authentication: No credentials required.

    Advanced Options

    OpenSearch options

    • Show hidden indices that start with a dot (.).

    • Use Painless scripting with OpenSearch 5.0+ (Checked as a default).

    • Show _id columns.

    • Use index/doc fields when pushing down aggregates and filters on analyzed and normalized fields (may produce unexpected results).

    • Use scripts for query pushdown** (Checked as a default).

    • If the number of records returned from OpenSearch is less than the expected number, warn instead of failing the query.

    • Read timeout (seconds) (default: 60)

    • Scroll timeout (seconds) (default: 300)

    • Scroll size – This setting must be less than or equal to your OpenSearch value for the index.max_result-window setting. (default: 4000)


    Validation modes include:

    • Validate certificate and hostname (default)
    • Validate certificate only
    • Do not validate certificate or hostname


    • Overwrite reqion – If the box is checked, provide the region.

    Reflection Refresh

    • Never refresh – Specifies how often to refresh based on hours, days, weeks, or never.
    • Never expire – Specifies how often to expire based on hours, days, weeks, or never.


    Dataset Handling

    • Remove dataset definitions if underlying data is unavailable (Default).
      If this box is not checked and the underlying files under a folder are removed or the folder/source is not accessible, Dremio does not remove the dataset definitions. This option is useful in cases when files are temporarily deleted and put back in place with new sets of files.

    Metadata Refresh

    • Dataset Discovery – Refresh interval for top-level source object names such as names of DBs and tables.
      • Fetch every – Specify fetch time based on minutes, hours, days, or weeks. Default: 1 hour
    • Dataset Details – The metadata that Dremio needs for query planning such as information needed for fields, types, shards, statistics, and locality.
      • Fetch mode – Specify either Only Queried Datasets, All Datasets, or As Needed. Default: Only Queried Datasets
        • Only Queried Datasets – Dremio updates details for previously queried objects in a source.
          This mode increases query performance because less work is needed at query time for these datasets.
        • All Datasets – Dremio updates details for all datasets in a source. This mode increases query performance because less work is needed at query time.
        • As Needed – Dremio updates details for a dataset at query time. This mode minimized metadata queries on a source when not used, but might lead to longer planning times.
      • Fetch every – Specify fetch time based on minutes, hours, days, or weeks. Default: 1 hour
      • Expire after – Specify expiration time based on minutes, hours, days, or weeks. Default: 3 hours


    You can specify which users can edit. Options include:

    • All users can edit.
    • Specific users can edit.