es

by tj

tj / es

Go DSL for Elasticsearch queries

204 Stars 5 Forks Last release: Not found 20 Commits 0 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

ES

Package es provides an Elasticsearch query DSL.

About

The use of Go "dot imports" is discouraged, however I'd recommend abstracting this logic into higher level query functions and packages if you'd like to utilize the expressiveness of dot imports in this scenario. I wouldn't recommend dot-importing it into other packages directly.

Example

Lispy

If you don't mind crazy nesting:

query := Pretty(Query(
  Aggs(
    Agg("results",
      Filter(
        Term("user.login", "tj"),
        Range("now-7d", "now"),
      )(
        Aggs(
          Agg("repos",
            Terms("repository.name.keyword", 100),
            Aggs(
              Agg("labels",
                Terms("issue.labels.keyword", 100),
                Aggs(
                  Agg("duration_sum", Sum("duration"))))))))))))

Less lispy

If you do mind crazy nesting:

labels := Aggs(
  Agg("labels",
    Terms("issue.labels.keyword", 100),
    Aggs(
      Agg("duration_sum",
        Sum("duration")))))

repos := Aggs( Agg("repos", Terms("repository.name.keyword", 100), labels))

filter := Filter( Term("user.login", "tj"), Range("now-7d", "now"))

results := Aggs( Agg("results", filter(repos)))

query := Pretty(Query(results))

Both yielding:

{
  "aggs": {
    "results": {
      "aggs": {
        "repos": {
          "aggs": {
            "labels": {
              "aggs": {
                "duration_sum": {
                  "sum": {
                    "field": "duration"
                  }
                }
              },
              "terms": {
                "field": "issue.labels.keyword",
                "size": 100
              }
            }
          },
          "terms": {
            "field": "repository.name.keyword",
            "size": 100
          }
        }
      },
      "filter": {
        "bool": {
          "filter": [
            {
              "term": {
                "user.login": "tj"
              }
            },
            {
              "range": {
                "timestamp": {
                  "gte": "now-7d",
                  "lte": "now"
                }
              }
            }
          ]
        }
      }
    }
  },
  "size": 0
}

Reuse

This also makes reuse more trivial, for example note how

sum
is re-used in the following snippet to fetch global, daily, and label-level summation.
sum := Agg("duration_sum", Sum("duration"))

labels := Agg("labels", Terms("issue.labels.keyword", 100), Aggs(sum))

days := Agg("days", DateHistogram("1d"), Aggs(sum, labels))

query := Query(Aggs(sum, labels, days))

Yielding:

{
  "aggs": {
    "days": {
      "aggs": {
        "duration_sum": {
          "sum": {
            "field": "duration"
          }
        },
        "labels": {
          "aggs": {
            "duration_sum": {
              "sum": {
                "field": "duration"
              }
            }
          },
          "terms": {
            "field": "issue.labels.keyword",
            "size": 100
          }
        }
      },
      "date_histogram": {
        "field": "timestamp",
        "interval": "1d"
      }
    },
    "duration_sum": {
      "sum": {
        "field": "duration"
      }
    },
    "labels": {
      "aggs": {
        "duration_sum": {
          "sum": {
            "field": "duration"
          }
        }
      },
      "terms": {
        "field": "issue.labels.keyword",
        "size": 100
      }
    }
  },
  "size": 0
}

GoDoc

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.