activerecord-analyze 0.6.0 → 0.9.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/README.md +10 -10
- data/lib/activerecord-analyze/main.rb +14 -8
- data/lib/activerecord-analyze/version.rb +1 -1
- data/spec/main_spec.rb +23 -0
- metadata +2 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: '09f3c691a676a55f45059cbfd0e12161e42f7ab87acdc834c1f496a2ceae1c1f'
|
4
|
+
data.tar.gz: c83a3d1bb42bdbbb82ca80f00acc55d420de1c7589660f8fd72f103f19aca0c4
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 96e5ba8e107b9d005f59e6ffe3ff0925b872c753b51ef9deee505919d415e3165a67d5bfe1cffa6f29dbd34eb6726e65f93f14d52389bcdd736edc636c25d0e5
|
7
|
+
data.tar.gz: 957325a0f295e28c76689b504a92a4d0aa636965f6a71326004c3662256aef769ca24bf75bd81a823d2fd3281b9f49d805e0a63dedda3bc5c392f7790cfd0cde
|
data/README.md
CHANGED
@@ -1,4 +1,4 @@
|
|
1
|
-
# ActiveRecord Analyze [](https://badge.fury.io/rb/
|
1
|
+
# ActiveRecord Analyze [](https://badge.fury.io/rb/activerecord-analyze) [](https://circleci.com/gh/pawurb/activerecord-analyze)
|
2
2
|
|
3
3
|
This gem adds an `analyze` method to Active Record query objects. It executes `EXPLAIN ANALYZE` on a query SQL.
|
4
4
|
|
@@ -23,21 +23,21 @@ gem 'activerecord-analyze'
|
|
23
23
|
The `analyze` method supports the following EXPLAIN query options ([PostgreSQL docs reference](https://www.postgresql.org/docs/12/sql-explain.html)):
|
24
24
|
|
25
25
|
```
|
26
|
-
|
27
|
-
|
28
|
-
|
29
|
-
|
30
|
-
|
31
|
-
|
32
|
-
|
26
|
+
buffers: [ boolean ]
|
27
|
+
verbose: [ boolean ]
|
28
|
+
costs: [ boolean ]
|
29
|
+
settings: [ boolean ]
|
30
|
+
timing: [ boolean ]
|
31
|
+
summary: [ boolean ]
|
32
|
+
format: { :text | :json | :xml | :yaml | :pretty_json }
|
33
33
|
```
|
34
34
|
|
35
35
|
You can execute it like that:
|
36
36
|
|
37
37
|
```ruby
|
38
38
|
|
39
|
-
User.all.analyze(
|
40
|
-
format: :
|
39
|
+
puts User.all.analyze(
|
40
|
+
format: :pretty_json, # :pretty_json format option generates a formatted JSON output
|
41
41
|
verbose: true,
|
42
42
|
costs: true,
|
43
43
|
settings: true,
|
@@ -6,15 +6,19 @@ module ActiveRecord
|
|
6
6
|
format_sql = if fmt = opts[:format].presence
|
7
7
|
case fmt
|
8
8
|
when :json
|
9
|
-
"FORMAT JSON,"
|
9
|
+
"FORMAT JSON, "
|
10
10
|
when :hash
|
11
|
-
"FORMAT JSON,"
|
11
|
+
"FORMAT JSON, "
|
12
|
+
when :pretty_json
|
13
|
+
"FORMAT JSON, "
|
12
14
|
when :yaml
|
13
|
-
"FORMAT YAML,"
|
15
|
+
"FORMAT YAML, "
|
14
16
|
when :text
|
15
|
-
"FORMAT TEXT,"
|
17
|
+
"FORMAT TEXT, "
|
16
18
|
when :xml
|
17
|
-
"FORMAT XML,"
|
19
|
+
"FORMAT XML, "
|
20
|
+
else
|
21
|
+
""
|
18
22
|
end
|
19
23
|
end
|
20
24
|
|
@@ -48,7 +52,7 @@ module ActiveRecord
|
|
48
52
|
"ANALYZE"
|
49
53
|
end
|
50
54
|
|
51
|
-
opts_sql = "(#{format_sql}
|
55
|
+
opts_sql = "(#{format_sql}#{analyze_sql}#{verbose_sql}#{costs_sql}#{settings_sql}#{buffers_sql}#{timing_sql}#{summary_sql})"
|
52
56
|
.strip.gsub(/\s+/, " ")
|
53
57
|
.gsub(/\(\s?\s?\s?,/, "(")
|
54
58
|
.gsub(/\s,\s/, " ")
|
@@ -66,8 +70,8 @@ module ActiveRecord
|
|
66
70
|
class Relation
|
67
71
|
def analyze(opts = {})
|
68
72
|
res = exec_analyze(collecting_queries_for_explain { exec_queries }, opts)
|
69
|
-
if [:json, :hash].include?(opts[:format])
|
70
|
-
start = res.index("[")
|
73
|
+
if [:json, :hash, :pretty_json].include?(opts[:format])
|
74
|
+
start = res.index("[\n")
|
71
75
|
finish = res.rindex("]")
|
72
76
|
raw_json = res.slice(start, finish - start + 1)
|
73
77
|
|
@@ -75,6 +79,8 @@ module ActiveRecord
|
|
75
79
|
JSON.parse(raw_json).to_json
|
76
80
|
elsif opts[:format] == :hash
|
77
81
|
JSON.parse(raw_json)
|
82
|
+
elsif opts[:format] == :pretty_json
|
83
|
+
JSON.pretty_generate(JSON.parse(raw_json))
|
78
84
|
end
|
79
85
|
else
|
80
86
|
res
|
data/spec/main_spec.rb
CHANGED
@@ -40,4 +40,27 @@ describe "ActiveRecord analyze" do
|
|
40
40
|
]
|
41
41
|
end
|
42
42
|
end
|
43
|
+
|
44
|
+
describe "format pretty" do
|
45
|
+
it "works" do
|
46
|
+
result = User.all.analyze(format: :pretty_json)
|
47
|
+
expect(JSON.parse(result)[0].keys.sort).to eq [
|
48
|
+
"Execution Time", "Plan", "Planning Time", "Triggers"
|
49
|
+
]
|
50
|
+
end
|
51
|
+
end
|
52
|
+
|
53
|
+
describe "supports options" do
|
54
|
+
it "works" do
|
55
|
+
result = User.all.limit(10).where.not(email: nil).analyze(
|
56
|
+
format: :hash,
|
57
|
+
costs: true,
|
58
|
+
timing: true,
|
59
|
+
summary: true
|
60
|
+
)
|
61
|
+
expect(result[0].keys.sort).to eq [
|
62
|
+
"Execution Time", "Plan", "Planning Time", "Triggers"
|
63
|
+
]
|
64
|
+
end
|
65
|
+
end
|
43
66
|
end
|
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: activerecord-analyze
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 0.
|
4
|
+
version: 0.9.1
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- pawurb
|
8
8
|
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
|
-
date: 2021-04-
|
11
|
+
date: 2021-04-11 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: rails
|