Assigns an alias to a given index, simultaneously removing it from prior indexes, with zero downtime.

Example

iex> Index.create_from_file(Cluster, "posts-1", "test/support/settings/posts.json")
...> Index.alias(Cluster, "posts-1", "posts")
:ok

Generates a name for an index that will be aliased to a given alias. Similar to migrations, the name will contain a timestamp.

Example

Index.build_name("main")
# => "main-1509581256"

Removes indexes starting with the given prefix, keeping a certain number.

Can be used to garbage collect old indexes that are no longer used.

Examples

If there is only one index, and num_to_keep is >= 1, the index is not deleted.

iex> Index.create_from_file(Cluster, "posts-1", "test/support/settings/posts.json")
...> Index.clean_starting_with(Cluster, "posts", 1)
...> Index.starting_with(Cluster, "posts")
{:ok, ["posts-1"]}

If num_to_keep is less than the number of indexes, the older indexes are deleted.

iex> Index.create_from_file(Cluster, "posts-1", "test/support/settings/posts.json")
...> Index.clean_starting_with(Cluster, "posts", 0)
...> Index.starting_with(Cluster, "posts")
{:ok, []}

Creates an index with the given name from either a JSON string or Elixir map.

Examples

iex> Index.create(Cluster, "posts-1", "{}")
:ok

Creates an index with the given name, with settings loaded from a JSON file.

Example

iex> Index.create_from_file(Cluster, "posts-1", "test/support/settings/posts.json")
:ok

iex> Index.create_from_file(Cluster, "posts-1", "nonexistent.json")
{:error, :enoent}

The posts.json file contains regular index settings as described in the Elasticsearch documentation:

{
  "mappings": {
    "post": {
      "properties": {
        "title": {
          "type": "string"
        },
        "author": {
          "type": "string"
        }
      }
    }
  }
}

Creates an index using a zero-downtime hot-swap technique.

1. Build an index for the given alias, with a timestamp: alias-12323123
2. Bulk upload data to that index using store and sources.
3. Alias the alias to alias-12323123.
4. Remove old indexes beginning with alias.
5. Refresh alias-12323123.

This allows an old index to be served while a new index for alias is built.

Example

iex> Index.hot_swap(Cluster, "posts")
:ok

Gets the most recent index name with the given prefix.

Examples

iex> Index.create_from_file(Cluster, "posts-1", "test/support/settings/posts.json")
...> Index.create_from_file(Cluster, "posts-2", "test/support/settings/posts.json")
...> Index.latest_starting_with(Cluster, "posts")
{:ok, "posts-2"}

If there are no indexes matching that prefix:

iex> Index.latest_starting_with(Cluster, "nonexistent")
{:error, :not_found}

Same as refresh/1, but raises an error on failure.

Examples

iex> Index.create_from_file(Cluster, "posts-1", "test/support/settings/posts.json")
...> Index.refresh!(Cluster, "posts-1")
:ok

iex> Index.refresh!(Cluster, "nonexistent")
** (Elasticsearch.Exception) (index_not_found_exception) no such index

Refreshes a given index with recently added data.

Example

iex> Index.create_from_file(Cluster, "posts-1", "test/support/settings/posts.json")
...> Index.refresh(Cluster, "posts-1")
:ok

Returns all indexes which start with a given string.

Example

iex> Index.create_from_file(Cluster, "posts-1", "test/support/settings/posts.json")
...> Index.starting_with(Cluster, "posts")
{:ok, ["posts-1"]}