heroku 11.6.0 → 11.7.0

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.
Files changed (41) hide show
  1. package/CHANGELOG.md +12 -0
  2. package/dist/commands/auth/whoami.js +1 -1
  3. package/dist/commands/pg/cache-hit.d.ts +16 -0
  4. package/dist/commands/pg/cache-hit.js +40 -0
  5. package/dist/commands/pg/calls.d.ts +19 -0
  6. package/dist/commands/pg/calls.js +55 -0
  7. package/dist/commands/pg/extensions.d.ts +16 -0
  8. package/dist/commands/pg/extensions.js +39 -0
  9. package/dist/commands/pg/fdwsql.d.ts +16 -0
  10. package/dist/commands/pg/fdwsql.js +70 -0
  11. package/dist/commands/pg/index-size.d.ts +16 -0
  12. package/dist/commands/pg/index-size.js +40 -0
  13. package/dist/commands/pg/index-usage.d.ts +16 -0
  14. package/dist/commands/pg/index-usage.js +41 -0
  15. package/dist/commands/pg/long-running-queries.d.ts +16 -0
  16. package/dist/commands/pg/long-running-queries.js +43 -0
  17. package/dist/commands/pg/mandelbrot.d.ts +15 -0
  18. package/dist/commands/pg/mandelbrot.js +49 -0
  19. package/dist/commands/pg/records-rank.d.ts +16 -0
  20. package/dist/commands/pg/records-rank.js +38 -0
  21. package/dist/commands/pg/seq-scans.d.ts +16 -0
  22. package/dist/commands/pg/seq-scans.js +36 -0
  23. package/dist/commands/pg/stats-reset.d.ts +15 -0
  24. package/dist/commands/pg/stats-reset.js +34 -0
  25. package/dist/commands/pg/table-indexes-size.d.ts +16 -0
  26. package/dist/commands/pg/table-indexes-size.js +39 -0
  27. package/dist/commands/pg/table-size.d.ts +16 -0
  28. package/dist/commands/pg/table-size.js +39 -0
  29. package/dist/commands/pg/total-index-size.d.ts +16 -0
  30. package/dist/commands/pg/total-index-size.js +37 -0
  31. package/dist/commands/pg/total-table-size.d.ts +16 -0
  32. package/dist/commands/pg/total-table-size.js +39 -0
  33. package/dist/commands/pg/unused-indexes.d.ts +16 -0
  34. package/dist/commands/pg/unused-indexes.js +41 -0
  35. package/dist/commands/pg/user-connections.d.ts +16 -0
  36. package/dist/commands/pg/user-connections.js +38 -0
  37. package/dist/lib/pg/extras.d.ts +11 -0
  38. package/dist/lib/pg/extras.js +57 -0
  39. package/npm-shrinkwrap.json +2 -2
  40. package/oclif.manifest.json +1173 -165
  41. package/package.json +2 -2
@@ -7536,6 +7536,130 @@
7536
7536
  "blocking.js"
7537
7537
  ]
7538
7538
  },
7539
+ "pg:cache-hit": {
7540
+ "aliases": [],
7541
+ "args": {
7542
+ "database": {
7543
+ "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
7544
+ "name": "database",
7545
+ "required": false
7546
+ }
7547
+ },
7548
+ "description": "show index and table hit rate",
7549
+ "examples": [
7550
+ "$ heroku pg:cache-hit --app example-app \n"
7551
+ ],
7552
+ "flags": {
7553
+ "prompt": {
7554
+ "description": "interactively prompt for command arguments and flags",
7555
+ "helpGroup": "GLOBAL",
7556
+ "name": "prompt",
7557
+ "allowNo": false,
7558
+ "type": "boolean"
7559
+ },
7560
+ "app": {
7561
+ "char": "a",
7562
+ "description": "app to run command against",
7563
+ "name": "app",
7564
+ "required": true,
7565
+ "hasDynamicHelp": true,
7566
+ "multiple": false,
7567
+ "type": "option"
7568
+ },
7569
+ "remote": {
7570
+ "char": "r",
7571
+ "description": "git remote of app to use",
7572
+ "name": "remote",
7573
+ "hasDynamicHelp": false,
7574
+ "multiple": false,
7575
+ "type": "option"
7576
+ }
7577
+ },
7578
+ "hasDynamicHelp": true,
7579
+ "hiddenAliases": [
7580
+ "pg:cache_hit"
7581
+ ],
7582
+ "id": "pg:cache-hit",
7583
+ "pluginAlias": "heroku",
7584
+ "pluginName": "heroku",
7585
+ "pluginType": "core",
7586
+ "strict": true,
7587
+ "enableJsonFlag": false,
7588
+ "promptFlagActive": true,
7589
+ "topic": "pg",
7590
+ "isESM": true,
7591
+ "relativePath": [
7592
+ "dist",
7593
+ "commands",
7594
+ "pg",
7595
+ "cache-hit.js"
7596
+ ]
7597
+ },
7598
+ "pg:calls": {
7599
+ "aliases": [],
7600
+ "args": {
7601
+ "database": {
7602
+ "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
7603
+ "name": "database",
7604
+ "required": false
7605
+ }
7606
+ },
7607
+ "description": "show 10 queries that have highest frequency of execution",
7608
+ "examples": [
7609
+ "$ heroku pg:calls --app example-app \n",
7610
+ "# truncate queries to 40 characters\n $ heroku pg:calls --truncate --app example-app \n"
7611
+ ],
7612
+ "flags": {
7613
+ "prompt": {
7614
+ "description": "interactively prompt for command arguments and flags",
7615
+ "helpGroup": "GLOBAL",
7616
+ "name": "prompt",
7617
+ "allowNo": false,
7618
+ "type": "boolean"
7619
+ },
7620
+ "app": {
7621
+ "char": "a",
7622
+ "description": "app to run command against",
7623
+ "name": "app",
7624
+ "required": true,
7625
+ "hasDynamicHelp": true,
7626
+ "multiple": false,
7627
+ "type": "option"
7628
+ },
7629
+ "remote": {
7630
+ "char": "r",
7631
+ "description": "git remote of app to use",
7632
+ "name": "remote",
7633
+ "hasDynamicHelp": false,
7634
+ "multiple": false,
7635
+ "type": "option"
7636
+ },
7637
+ "truncate": {
7638
+ "char": "t",
7639
+ "description": "truncate queries to 40 characters",
7640
+ "name": "truncate",
7641
+ "allowNo": false,
7642
+ "type": "boolean"
7643
+ }
7644
+ },
7645
+ "hasDynamicHelp": true,
7646
+ "hiddenAliases": [],
7647
+ "id": "pg:calls",
7648
+ "pluginAlias": "heroku",
7649
+ "pluginName": "heroku",
7650
+ "pluginType": "core",
7651
+ "strict": true,
7652
+ "enableJsonFlag": false,
7653
+ "promptFlagActive": true,
7654
+ "topic": "pg",
7655
+ "isESM": true,
7656
+ "relativePath": [
7657
+ "dist",
7658
+ "commands",
7659
+ "pg",
7660
+ "calls.js"
7661
+ ]
7662
+ },
7539
7663
  "pg:copy": {
7540
7664
  "aliases": [],
7541
7665
  "args": {
@@ -7731,17 +7855,19 @@
7731
7855
  "diagnose.js"
7732
7856
  ]
7733
7857
  },
7734
- "pg:info": {
7735
- "aliases": [
7736
- "pg"
7737
- ],
7858
+ "pg:extensions": {
7859
+ "aliases": [],
7738
7860
  "args": {
7739
7861
  "database": {
7740
- "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use all databases.",
7741
- "name": "database"
7862
+ "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
7863
+ "name": "database",
7864
+ "required": false
7742
7865
  }
7743
7866
  },
7744
- "description": "show database information",
7867
+ "description": "list available and installed extensions",
7868
+ "examples": [
7869
+ "$ heroku pg:extensions --app example-app \n"
7870
+ ],
7745
7871
  "flags": {
7746
7872
  "prompt": {
7747
7873
  "description": "interactively prompt for command arguments and flags",
@@ -7770,7 +7896,7 @@
7770
7896
  },
7771
7897
  "hasDynamicHelp": true,
7772
7898
  "hiddenAliases": [],
7773
- "id": "pg:info",
7899
+ "id": "pg:extensions",
7774
7900
  "pluginAlias": "heroku",
7775
7901
  "pluginName": "heroku",
7776
7902
  "pluginType": "core",
@@ -7783,23 +7909,27 @@
7783
7909
  "dist",
7784
7910
  "commands",
7785
7911
  "pg",
7786
- "info.js"
7912
+ "extensions.js"
7787
7913
  ]
7788
7914
  },
7789
- "pg:kill": {
7915
+ "pg:fdwsql": {
7790
7916
  "aliases": [],
7791
7917
  "args": {
7792
- "pid": {
7793
- "description": "ID of the process",
7794
- "name": "pid",
7918
+ "prefix": {
7919
+ "description": "prefix for foreign data wrapper",
7920
+ "name": "prefix",
7795
7921
  "required": true
7796
7922
  },
7797
7923
  "database": {
7798
7924
  "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
7799
- "name": "database"
7925
+ "name": "database",
7926
+ "required": false
7800
7927
  }
7801
7928
  },
7802
- "description": "kill a query",
7929
+ "description": "generate fdw install sql for database",
7930
+ "examples": [
7931
+ "$ heroku pg:fdwsql example_prefix --app example-app \n"
7932
+ ],
7803
7933
  "flags": {
7804
7934
  "prompt": {
7805
7935
  "description": "interactively prompt for command arguments and flags",
@@ -7817,12 +7947,6 @@
7817
7947
  "multiple": false,
7818
7948
  "type": "option"
7819
7949
  },
7820
- "force": {
7821
- "char": "f",
7822
- "name": "force",
7823
- "allowNo": false,
7824
- "type": "boolean"
7825
- },
7826
7950
  "remote": {
7827
7951
  "char": "r",
7828
7952
  "description": "git remote of app to use",
@@ -7834,7 +7958,7 @@
7834
7958
  },
7835
7959
  "hasDynamicHelp": true,
7836
7960
  "hiddenAliases": [],
7837
- "id": "pg:kill",
7961
+ "id": "pg:fdwsql",
7838
7962
  "pluginAlias": "heroku",
7839
7963
  "pluginName": "heroku",
7840
7964
  "pluginType": "core",
@@ -7847,18 +7971,22 @@
7847
7971
  "dist",
7848
7972
  "commands",
7849
7973
  "pg",
7850
- "kill.js"
7974
+ "fdwsql.js"
7851
7975
  ]
7852
7976
  },
7853
- "pg:killall": {
7977
+ "pg:index-size": {
7854
7978
  "aliases": [],
7855
7979
  "args": {
7856
7980
  "database": {
7857
7981
  "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
7858
- "name": "database"
7982
+ "name": "database",
7983
+ "required": false
7859
7984
  }
7860
7985
  },
7861
- "description": "terminates all connections for all credentials",
7986
+ "description": "show the size of indexes, descending by size",
7987
+ "examples": [
7988
+ "$ heroku pg:index-size --app example-app \n"
7989
+ ],
7862
7990
  "flags": {
7863
7991
  "prompt": {
7864
7992
  "description": "interactively prompt for command arguments and flags",
@@ -7886,8 +8014,10 @@
7886
8014
  }
7887
8015
  },
7888
8016
  "hasDynamicHelp": true,
7889
- "hiddenAliases": [],
7890
- "id": "pg:killall",
8017
+ "hiddenAliases": [
8018
+ "pg:index_size"
8019
+ ],
8020
+ "id": "pg:index-size",
7891
8021
  "pluginAlias": "heroku",
7892
8022
  "pluginName": "heroku",
7893
8023
  "pluginType": "core",
@@ -7900,18 +8030,22 @@
7900
8030
  "dist",
7901
8031
  "commands",
7902
8032
  "pg",
7903
- "killall.js"
8033
+ "index-size.js"
7904
8034
  ]
7905
8035
  },
7906
- "pg:locks": {
8036
+ "pg:index-usage": {
7907
8037
  "aliases": [],
7908
8038
  "args": {
7909
8039
  "database": {
7910
8040
  "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
7911
- "name": "database"
8041
+ "name": "database",
8042
+ "required": false
7912
8043
  }
7913
8044
  },
7914
- "description": "display queries with active locks",
8045
+ "description": "calculates your index hit rate (effective databases are at 99% and up)",
8046
+ "examples": [
8047
+ "$ heroku pg:index-usage --app example-app \n"
8048
+ ],
7915
8049
  "flags": {
7916
8050
  "prompt": {
7917
8051
  "description": "interactively prompt for command arguments and flags",
@@ -7936,18 +8070,13 @@
7936
8070
  "hasDynamicHelp": false,
7937
8071
  "multiple": false,
7938
8072
  "type": "option"
7939
- },
7940
- "truncate": {
7941
- "char": "t",
7942
- "description": "truncates queries to 40 characters",
7943
- "name": "truncate",
7944
- "allowNo": false,
7945
- "type": "boolean"
7946
8073
  }
7947
8074
  },
7948
8075
  "hasDynamicHelp": true,
7949
- "hiddenAliases": [],
7950
- "id": "pg:locks",
8076
+ "hiddenAliases": [
8077
+ "pg:index_usage"
8078
+ ],
8079
+ "id": "pg:index-usage",
7951
8080
  "pluginAlias": "heroku",
7952
8081
  "pluginName": "heroku",
7953
8082
  "pluginType": "core",
@@ -7960,18 +8089,20 @@
7960
8089
  "dist",
7961
8090
  "commands",
7962
8091
  "pg",
7963
- "locks.js"
8092
+ "index-usage.js"
7964
8093
  ]
7965
8094
  },
7966
- "pg:outliers": {
7967
- "aliases": [],
8095
+ "pg:info": {
8096
+ "aliases": [
8097
+ "pg"
8098
+ ],
7968
8099
  "args": {
7969
8100
  "database": {
7970
- "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
8101
+ "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use all databases.",
7971
8102
  "name": "database"
7972
8103
  }
7973
8104
  },
7974
- "description": "show 10 queries that have longest execution time in aggregate",
8105
+ "description": "show database information",
7975
8106
  "flags": {
7976
8107
  "prompt": {
7977
8108
  "description": "interactively prompt for command arguments and flags",
@@ -7989,14 +8120,6 @@
7989
8120
  "multiple": false,
7990
8121
  "type": "option"
7991
8122
  },
7992
- "num": {
7993
- "char": "n",
7994
- "description": "the number of queries to display (default: 10)",
7995
- "name": "num",
7996
- "hasDynamicHelp": false,
7997
- "multiple": false,
7998
- "type": "option"
7999
- },
8000
8123
  "remote": {
8001
8124
  "char": "r",
8002
8125
  "description": "git remote of app to use",
@@ -8004,24 +8127,11 @@
8004
8127
  "hasDynamicHelp": false,
8005
8128
  "multiple": false,
8006
8129
  "type": "option"
8007
- },
8008
- "reset": {
8009
- "description": "resets statistics gathered by pg_stat_statements",
8010
- "name": "reset",
8011
- "allowNo": false,
8012
- "type": "boolean"
8013
- },
8014
- "truncate": {
8015
- "char": "t",
8016
- "description": "truncate queries to 40 characters",
8017
- "name": "truncate",
8018
- "allowNo": false,
8019
- "type": "boolean"
8020
8130
  }
8021
8131
  },
8022
8132
  "hasDynamicHelp": true,
8023
8133
  "hiddenAliases": [],
8024
- "id": "pg:outliers",
8134
+ "id": "pg:info",
8025
8135
  "pluginAlias": "heroku",
8026
8136
  "pluginName": "heroku",
8027
8137
  "pluginType": "core",
@@ -8034,19 +8144,23 @@
8034
8144
  "dist",
8035
8145
  "commands",
8036
8146
  "pg",
8037
- "outliers.js"
8147
+ "info.js"
8038
8148
  ]
8039
8149
  },
8040
- "pg:promote": {
8150
+ "pg:kill": {
8041
8151
  "aliases": [],
8042
8152
  "args": {
8043
- "database": {
8044
- "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::`",
8045
- "name": "database",
8153
+ "pid": {
8154
+ "description": "ID of the process",
8155
+ "name": "pid",
8046
8156
  "required": true
8157
+ },
8158
+ "database": {
8159
+ "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
8160
+ "name": "database"
8047
8161
  }
8048
8162
  },
8049
- "description": "sets DATABASE as your DATABASE_URL",
8163
+ "description": "kill a query",
8050
8164
  "flags": {
8051
8165
  "prompt": {
8052
8166
  "description": "interactively prompt for command arguments and flags",
@@ -8081,7 +8195,7 @@
8081
8195
  },
8082
8196
  "hasDynamicHelp": true,
8083
8197
  "hiddenAliases": [],
8084
- "id": "pg:promote",
8198
+ "id": "pg:kill",
8085
8199
  "pluginAlias": "heroku",
8086
8200
  "pluginName": "heroku",
8087
8201
  "pluginType": "core",
@@ -8094,10 +8208,10 @@
8094
8208
  "dist",
8095
8209
  "commands",
8096
8210
  "pg",
8097
- "promote.js"
8211
+ "kill.js"
8098
8212
  ]
8099
8213
  },
8100
- "pg:ps": {
8214
+ "pg:killall": {
8101
8215
  "aliases": [],
8102
8216
  "args": {
8103
8217
  "database": {
@@ -8105,7 +8219,7 @@
8105
8219
  "name": "database"
8106
8220
  }
8107
8221
  },
8108
- "description": "view active queries with execution time",
8222
+ "description": "terminates all connections for all credentials",
8109
8223
  "flags": {
8110
8224
  "prompt": {
8111
8225
  "description": "interactively prompt for command arguments and flags",
@@ -8130,17 +8244,11 @@
8130
8244
  "hasDynamicHelp": false,
8131
8245
  "multiple": false,
8132
8246
  "type": "option"
8133
- },
8134
- "verbose": {
8135
- "char": "v",
8136
- "name": "verbose",
8137
- "allowNo": false,
8138
- "type": "boolean"
8139
8247
  }
8140
8248
  },
8141
8249
  "hasDynamicHelp": true,
8142
8250
  "hiddenAliases": [],
8143
- "id": "pg:ps",
8251
+ "id": "pg:killall",
8144
8252
  "pluginAlias": "heroku",
8145
8253
  "pluginName": "heroku",
8146
8254
  "pluginType": "core",
@@ -8153,20 +8261,18 @@
8153
8261
  "dist",
8154
8262
  "commands",
8155
8263
  "pg",
8156
- "ps.js"
8264
+ "killall.js"
8157
8265
  ]
8158
8266
  },
8159
- "pg:psql": {
8160
- "aliases": [
8161
- "psql"
8162
- ],
8267
+ "pg:locks": {
8268
+ "aliases": [],
8163
8269
  "args": {
8164
8270
  "database": {
8165
8271
  "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
8166
8272
  "name": "database"
8167
8273
  }
8168
8274
  },
8169
- "description": "open a psql shell to the database",
8275
+ "description": "display queries with active locks",
8170
8276
  "flags": {
8171
8277
  "prompt": {
8172
8278
  "description": "interactively prompt for command arguments and flags",
@@ -8184,26 +8290,779 @@
8184
8290
  "multiple": false,
8185
8291
  "type": "option"
8186
8292
  },
8187
- "command": {
8188
- "char": "c",
8189
- "description": "SQL command to run",
8190
- "name": "command",
8191
- "hasDynamicHelp": false,
8293
+ "remote": {
8294
+ "char": "r",
8295
+ "description": "git remote of app to use",
8296
+ "name": "remote",
8297
+ "hasDynamicHelp": false,
8298
+ "multiple": false,
8299
+ "type": "option"
8300
+ },
8301
+ "truncate": {
8302
+ "char": "t",
8303
+ "description": "truncates queries to 40 characters",
8304
+ "name": "truncate",
8305
+ "allowNo": false,
8306
+ "type": "boolean"
8307
+ }
8308
+ },
8309
+ "hasDynamicHelp": true,
8310
+ "hiddenAliases": [],
8311
+ "id": "pg:locks",
8312
+ "pluginAlias": "heroku",
8313
+ "pluginName": "heroku",
8314
+ "pluginType": "core",
8315
+ "strict": true,
8316
+ "enableJsonFlag": false,
8317
+ "promptFlagActive": true,
8318
+ "topic": "pg",
8319
+ "isESM": true,
8320
+ "relativePath": [
8321
+ "dist",
8322
+ "commands",
8323
+ "pg",
8324
+ "locks.js"
8325
+ ]
8326
+ },
8327
+ "pg:long-running-queries": {
8328
+ "aliases": [],
8329
+ "args": {
8330
+ "database": {
8331
+ "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
8332
+ "name": "database",
8333
+ "required": false
8334
+ }
8335
+ },
8336
+ "description": "show all queries longer than five minutes by descending duration",
8337
+ "examples": [
8338
+ "$ heroku pg:long-running-queries --app example-app \n"
8339
+ ],
8340
+ "flags": {
8341
+ "prompt": {
8342
+ "description": "interactively prompt for command arguments and flags",
8343
+ "helpGroup": "GLOBAL",
8344
+ "name": "prompt",
8345
+ "allowNo": false,
8346
+ "type": "boolean"
8347
+ },
8348
+ "app": {
8349
+ "char": "a",
8350
+ "description": "app to run command against",
8351
+ "name": "app",
8352
+ "required": true,
8353
+ "hasDynamicHelp": true,
8354
+ "multiple": false,
8355
+ "type": "option"
8356
+ },
8357
+ "remote": {
8358
+ "char": "r",
8359
+ "description": "git remote of app to use",
8360
+ "name": "remote",
8361
+ "hasDynamicHelp": false,
8362
+ "multiple": false,
8363
+ "type": "option"
8364
+ }
8365
+ },
8366
+ "hasDynamicHelp": true,
8367
+ "hiddenAliases": [
8368
+ "pg:long_running_queries"
8369
+ ],
8370
+ "id": "pg:long-running-queries",
8371
+ "pluginAlias": "heroku",
8372
+ "pluginName": "heroku",
8373
+ "pluginType": "core",
8374
+ "strict": true,
8375
+ "enableJsonFlag": false,
8376
+ "promptFlagActive": true,
8377
+ "topic": "pg",
8378
+ "isESM": true,
8379
+ "relativePath": [
8380
+ "dist",
8381
+ "commands",
8382
+ "pg",
8383
+ "long-running-queries.js"
8384
+ ]
8385
+ },
8386
+ "pg:mandelbrot": {
8387
+ "aliases": [],
8388
+ "args": {
8389
+ "database": {
8390
+ "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
8391
+ "name": "database",
8392
+ "required": false
8393
+ }
8394
+ },
8395
+ "description": "show the mandelbrot set",
8396
+ "examples": [
8397
+ "$ heroku pg:mandelbrot --app example-app \n"
8398
+ ],
8399
+ "flags": {
8400
+ "prompt": {
8401
+ "description": "interactively prompt for command arguments and flags",
8402
+ "helpGroup": "GLOBAL",
8403
+ "name": "prompt",
8404
+ "allowNo": false,
8405
+ "type": "boolean"
8406
+ },
8407
+ "app": {
8408
+ "char": "a",
8409
+ "description": "app to run command against",
8410
+ "name": "app",
8411
+ "required": true,
8412
+ "hasDynamicHelp": true,
8413
+ "multiple": false,
8414
+ "type": "option"
8415
+ },
8416
+ "remote": {
8417
+ "char": "r",
8418
+ "description": "git remote of app to use",
8419
+ "name": "remote",
8420
+ "hasDynamicHelp": false,
8421
+ "multiple": false,
8422
+ "type": "option"
8423
+ }
8424
+ },
8425
+ "hasDynamicHelp": true,
8426
+ "hiddenAliases": [],
8427
+ "id": "pg:mandelbrot",
8428
+ "pluginAlias": "heroku",
8429
+ "pluginName": "heroku",
8430
+ "pluginType": "core",
8431
+ "strict": true,
8432
+ "enableJsonFlag": false,
8433
+ "promptFlagActive": true,
8434
+ "topic": "pg",
8435
+ "isESM": true,
8436
+ "relativePath": [
8437
+ "dist",
8438
+ "commands",
8439
+ "pg",
8440
+ "mandelbrot.js"
8441
+ ]
8442
+ },
8443
+ "pg:outliers": {
8444
+ "aliases": [],
8445
+ "args": {
8446
+ "database": {
8447
+ "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
8448
+ "name": "database"
8449
+ }
8450
+ },
8451
+ "description": "show 10 queries that have longest execution time in aggregate",
8452
+ "flags": {
8453
+ "prompt": {
8454
+ "description": "interactively prompt for command arguments and flags",
8455
+ "helpGroup": "GLOBAL",
8456
+ "name": "prompt",
8457
+ "allowNo": false,
8458
+ "type": "boolean"
8459
+ },
8460
+ "app": {
8461
+ "char": "a",
8462
+ "description": "app to run command against",
8463
+ "name": "app",
8464
+ "required": true,
8465
+ "hasDynamicHelp": true,
8466
+ "multiple": false,
8467
+ "type": "option"
8468
+ },
8469
+ "num": {
8470
+ "char": "n",
8471
+ "description": "the number of queries to display (default: 10)",
8472
+ "name": "num",
8473
+ "hasDynamicHelp": false,
8474
+ "multiple": false,
8475
+ "type": "option"
8476
+ },
8477
+ "remote": {
8478
+ "char": "r",
8479
+ "description": "git remote of app to use",
8480
+ "name": "remote",
8481
+ "hasDynamicHelp": false,
8482
+ "multiple": false,
8483
+ "type": "option"
8484
+ },
8485
+ "reset": {
8486
+ "description": "resets statistics gathered by pg_stat_statements",
8487
+ "name": "reset",
8488
+ "allowNo": false,
8489
+ "type": "boolean"
8490
+ },
8491
+ "truncate": {
8492
+ "char": "t",
8493
+ "description": "truncate queries to 40 characters",
8494
+ "name": "truncate",
8495
+ "allowNo": false,
8496
+ "type": "boolean"
8497
+ }
8498
+ },
8499
+ "hasDynamicHelp": true,
8500
+ "hiddenAliases": [],
8501
+ "id": "pg:outliers",
8502
+ "pluginAlias": "heroku",
8503
+ "pluginName": "heroku",
8504
+ "pluginType": "core",
8505
+ "strict": true,
8506
+ "enableJsonFlag": false,
8507
+ "promptFlagActive": true,
8508
+ "topic": "pg",
8509
+ "isESM": true,
8510
+ "relativePath": [
8511
+ "dist",
8512
+ "commands",
8513
+ "pg",
8514
+ "outliers.js"
8515
+ ]
8516
+ },
8517
+ "pg:promote": {
8518
+ "aliases": [],
8519
+ "args": {
8520
+ "database": {
8521
+ "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::`",
8522
+ "name": "database",
8523
+ "required": true
8524
+ }
8525
+ },
8526
+ "description": "sets DATABASE as your DATABASE_URL",
8527
+ "flags": {
8528
+ "prompt": {
8529
+ "description": "interactively prompt for command arguments and flags",
8530
+ "helpGroup": "GLOBAL",
8531
+ "name": "prompt",
8532
+ "allowNo": false,
8533
+ "type": "boolean"
8534
+ },
8535
+ "app": {
8536
+ "char": "a",
8537
+ "description": "app to run command against",
8538
+ "name": "app",
8539
+ "required": true,
8540
+ "hasDynamicHelp": true,
8541
+ "multiple": false,
8542
+ "type": "option"
8543
+ },
8544
+ "force": {
8545
+ "char": "f",
8546
+ "name": "force",
8547
+ "allowNo": false,
8548
+ "type": "boolean"
8549
+ },
8550
+ "remote": {
8551
+ "char": "r",
8552
+ "description": "git remote of app to use",
8553
+ "name": "remote",
8554
+ "hasDynamicHelp": false,
8555
+ "multiple": false,
8556
+ "type": "option"
8557
+ }
8558
+ },
8559
+ "hasDynamicHelp": true,
8560
+ "hiddenAliases": [],
8561
+ "id": "pg:promote",
8562
+ "pluginAlias": "heroku",
8563
+ "pluginName": "heroku",
8564
+ "pluginType": "core",
8565
+ "strict": true,
8566
+ "enableJsonFlag": false,
8567
+ "promptFlagActive": true,
8568
+ "topic": "pg",
8569
+ "isESM": true,
8570
+ "relativePath": [
8571
+ "dist",
8572
+ "commands",
8573
+ "pg",
8574
+ "promote.js"
8575
+ ]
8576
+ },
8577
+ "pg:ps": {
8578
+ "aliases": [],
8579
+ "args": {
8580
+ "database": {
8581
+ "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
8582
+ "name": "database"
8583
+ }
8584
+ },
8585
+ "description": "view active queries with execution time",
8586
+ "flags": {
8587
+ "prompt": {
8588
+ "description": "interactively prompt for command arguments and flags",
8589
+ "helpGroup": "GLOBAL",
8590
+ "name": "prompt",
8591
+ "allowNo": false,
8592
+ "type": "boolean"
8593
+ },
8594
+ "app": {
8595
+ "char": "a",
8596
+ "description": "app to run command against",
8597
+ "name": "app",
8598
+ "required": true,
8599
+ "hasDynamicHelp": true,
8600
+ "multiple": false,
8601
+ "type": "option"
8602
+ },
8603
+ "remote": {
8604
+ "char": "r",
8605
+ "description": "git remote of app to use",
8606
+ "name": "remote",
8607
+ "hasDynamicHelp": false,
8608
+ "multiple": false,
8609
+ "type": "option"
8610
+ },
8611
+ "verbose": {
8612
+ "char": "v",
8613
+ "name": "verbose",
8614
+ "allowNo": false,
8615
+ "type": "boolean"
8616
+ }
8617
+ },
8618
+ "hasDynamicHelp": true,
8619
+ "hiddenAliases": [],
8620
+ "id": "pg:ps",
8621
+ "pluginAlias": "heroku",
8622
+ "pluginName": "heroku",
8623
+ "pluginType": "core",
8624
+ "strict": true,
8625
+ "enableJsonFlag": false,
8626
+ "promptFlagActive": true,
8627
+ "topic": "pg",
8628
+ "isESM": true,
8629
+ "relativePath": [
8630
+ "dist",
8631
+ "commands",
8632
+ "pg",
8633
+ "ps.js"
8634
+ ]
8635
+ },
8636
+ "pg:psql": {
8637
+ "aliases": [
8638
+ "psql"
8639
+ ],
8640
+ "args": {
8641
+ "database": {
8642
+ "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
8643
+ "name": "database"
8644
+ }
8645
+ },
8646
+ "description": "open a psql shell to the database",
8647
+ "flags": {
8648
+ "prompt": {
8649
+ "description": "interactively prompt for command arguments and flags",
8650
+ "helpGroup": "GLOBAL",
8651
+ "name": "prompt",
8652
+ "allowNo": false,
8653
+ "type": "boolean"
8654
+ },
8655
+ "app": {
8656
+ "char": "a",
8657
+ "description": "app to run command against",
8658
+ "name": "app",
8659
+ "required": true,
8660
+ "hasDynamicHelp": true,
8661
+ "multiple": false,
8662
+ "type": "option"
8663
+ },
8664
+ "command": {
8665
+ "char": "c",
8666
+ "description": "SQL command to run",
8667
+ "name": "command",
8668
+ "hasDynamicHelp": false,
8669
+ "multiple": false,
8670
+ "type": "option"
8671
+ },
8672
+ "credential": {
8673
+ "description": "credential to use",
8674
+ "name": "credential",
8675
+ "hasDynamicHelp": false,
8676
+ "multiple": false,
8677
+ "type": "option"
8678
+ },
8679
+ "file": {
8680
+ "char": "f",
8681
+ "description": "SQL file to run",
8682
+ "name": "file",
8683
+ "hasDynamicHelp": false,
8684
+ "multiple": false,
8685
+ "type": "option"
8686
+ },
8687
+ "remote": {
8688
+ "char": "r",
8689
+ "description": "git remote of app to use",
8690
+ "name": "remote",
8691
+ "hasDynamicHelp": false,
8692
+ "multiple": false,
8693
+ "type": "option"
8694
+ }
8695
+ },
8696
+ "hasDynamicHelp": true,
8697
+ "hiddenAliases": [],
8698
+ "id": "pg:psql",
8699
+ "pluginAlias": "heroku",
8700
+ "pluginName": "heroku",
8701
+ "pluginType": "core",
8702
+ "strict": true,
8703
+ "enableJsonFlag": false,
8704
+ "promptFlagActive": true,
8705
+ "isESM": true,
8706
+ "relativePath": [
8707
+ "dist",
8708
+ "commands",
8709
+ "pg",
8710
+ "psql.js"
8711
+ ]
8712
+ },
8713
+ "pg:pull": {
8714
+ "aliases": [],
8715
+ "args": {
8716
+ "source": {
8717
+ "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
8718
+ "name": "source",
8719
+ "required": true
8720
+ },
8721
+ "target": {
8722
+ "description": "PostgreSQL connection string for the target database",
8723
+ "name": "target",
8724
+ "required": true
8725
+ }
8726
+ },
8727
+ "description": "pull Heroku database into local or remote database\nPull from SOURCE into TARGET.\n\nTARGET must be one of:\n* a database name (i.e. on a local PostgreSQL server) => TARGET must not exist and will be created\n* a fully qualified URL to a local PostgreSQL server => TARGET must not exist and will be created\n* a fully qualified URL to a remote PostgreSQL server => TARGET must exist and be empty\n\nTo delete a local database run dropdb TARGET.\nTo create an empty remote database, run createdb with connection command-line options (run createdb --help for details).\n",
8728
+ "examples": [
8729
+ "# pull Heroku DB named postgresql-swimmingly-100 into local DB mylocaldb that must not exist\n $ heroku pg:pull postgresql-swimmingly-100 mylocaldb --app sushi \n",
8730
+ "# pull Heroku DB named postgresql-swimmingly-100 into empty remote DB at postgres://myhost/mydb\n $ heroku pg:pull postgresql-swimmingly-100 postgres://myhost/mydb --app sushi \n"
8731
+ ],
8732
+ "flags": {
8733
+ "prompt": {
8734
+ "description": "interactively prompt for command arguments and flags",
8735
+ "helpGroup": "GLOBAL",
8736
+ "name": "prompt",
8737
+ "allowNo": false,
8738
+ "type": "boolean"
8739
+ },
8740
+ "app": {
8741
+ "char": "a",
8742
+ "description": "app to run command against",
8743
+ "name": "app",
8744
+ "required": true,
8745
+ "hasDynamicHelp": true,
8746
+ "multiple": false,
8747
+ "type": "option"
8748
+ },
8749
+ "exclude-table-data": {
8750
+ "description": "tables for which data should be excluded (use ';' to split multiple names)",
8751
+ "name": "exclude-table-data",
8752
+ "hasDynamicHelp": false,
8753
+ "multiple": false,
8754
+ "type": "option"
8755
+ },
8756
+ "remote": {
8757
+ "char": "r",
8758
+ "description": "git remote of app to use",
8759
+ "name": "remote",
8760
+ "hasDynamicHelp": false,
8761
+ "multiple": false,
8762
+ "type": "option"
8763
+ }
8764
+ },
8765
+ "hasDynamicHelp": true,
8766
+ "hiddenAliases": [],
8767
+ "id": "pg:pull",
8768
+ "pluginAlias": "heroku",
8769
+ "pluginName": "heroku",
8770
+ "pluginType": "core",
8771
+ "strict": true,
8772
+ "enableJsonFlag": false,
8773
+ "promptFlagActive": true,
8774
+ "topic": "pg",
8775
+ "isESM": true,
8776
+ "relativePath": [
8777
+ "dist",
8778
+ "commands",
8779
+ "pg",
8780
+ "pull.js"
8781
+ ]
8782
+ },
8783
+ "pg:push": {
8784
+ "aliases": [],
8785
+ "args": {
8786
+ "source": {
8787
+ "description": "PostgreSQL connection string for the source database",
8788
+ "name": "source",
8789
+ "required": true
8790
+ },
8791
+ "target": {
8792
+ "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
8793
+ "name": "target",
8794
+ "required": true
8795
+ }
8796
+ },
8797
+ "description": "push local or remote into Heroku database\nPush from SOURCE into TARGET. TARGET must be empty.\n\nTo empty a Heroku database for push run heroku pg:reset\n\nSOURCE must be either the name of a database existing on your localhost or the\nfully qualified URL of a remote database.\n",
8798
+ "examples": [
8799
+ "# push mylocaldb into a Heroku DB named postgresql-swimmingly-100\n$ heroku pg:push mylocaldb postgresql-swimmingly-100 --app sushi\n",
8800
+ "# push remote DB at postgres://myhost/mydb into a Heroku DB named postgresql-swimmingly-100\n$ heroku pg:push postgres://myhost/mydb postgresql-swimmingly-100 --app sushi\n"
8801
+ ],
8802
+ "flags": {
8803
+ "prompt": {
8804
+ "description": "interactively prompt for command arguments and flags",
8805
+ "helpGroup": "GLOBAL",
8806
+ "name": "prompt",
8807
+ "allowNo": false,
8808
+ "type": "boolean"
8809
+ },
8810
+ "app": {
8811
+ "char": "a",
8812
+ "description": "app to run command against",
8813
+ "name": "app",
8814
+ "required": true,
8815
+ "hasDynamicHelp": true,
8192
8816
  "multiple": false,
8193
8817
  "type": "option"
8194
8818
  },
8195
- "credential": {
8196
- "description": "credential to use",
8197
- "name": "credential",
8819
+ "exclude-table-data": {
8820
+ "description": "tables for which data should be excluded (use ';' to split multiple names)",
8821
+ "name": "exclude-table-data",
8822
+ "hasDynamicHelp": false,
8823
+ "multiple": false,
8824
+ "type": "option"
8825
+ },
8826
+ "remote": {
8827
+ "char": "r",
8828
+ "description": "git remote of app to use",
8829
+ "name": "remote",
8830
+ "hasDynamicHelp": false,
8831
+ "multiple": false,
8832
+ "type": "option"
8833
+ }
8834
+ },
8835
+ "hasDynamicHelp": true,
8836
+ "hiddenAliases": [],
8837
+ "id": "pg:push",
8838
+ "pluginAlias": "heroku",
8839
+ "pluginName": "heroku",
8840
+ "pluginType": "core",
8841
+ "strict": true,
8842
+ "enableJsonFlag": false,
8843
+ "promptFlagActive": true,
8844
+ "topic": "pg",
8845
+ "isESM": true,
8846
+ "relativePath": [
8847
+ "dist",
8848
+ "commands",
8849
+ "pg",
8850
+ "push.js"
8851
+ ]
8852
+ },
8853
+ "pg:records-rank": {
8854
+ "aliases": [],
8855
+ "args": {
8856
+ "database": {
8857
+ "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
8858
+ "name": "database",
8859
+ "required": false
8860
+ }
8861
+ },
8862
+ "description": "show all tables and the number of rows in each ordered by number of rows descending",
8863
+ "examples": [
8864
+ "$ heroku pg:records-rank --app example-app \n"
8865
+ ],
8866
+ "flags": {
8867
+ "prompt": {
8868
+ "description": "interactively prompt for command arguments and flags",
8869
+ "helpGroup": "GLOBAL",
8870
+ "name": "prompt",
8871
+ "allowNo": false,
8872
+ "type": "boolean"
8873
+ },
8874
+ "app": {
8875
+ "char": "a",
8876
+ "description": "app to run command against",
8877
+ "name": "app",
8878
+ "required": true,
8879
+ "hasDynamicHelp": true,
8880
+ "multiple": false,
8881
+ "type": "option"
8882
+ },
8883
+ "remote": {
8884
+ "char": "r",
8885
+ "description": "git remote of app to use",
8886
+ "name": "remote",
8887
+ "hasDynamicHelp": false,
8888
+ "multiple": false,
8889
+ "type": "option"
8890
+ }
8891
+ },
8892
+ "hasDynamicHelp": true,
8893
+ "hiddenAliases": [
8894
+ "pg:records_rank"
8895
+ ],
8896
+ "id": "pg:records-rank",
8897
+ "pluginAlias": "heroku",
8898
+ "pluginName": "heroku",
8899
+ "pluginType": "core",
8900
+ "strict": true,
8901
+ "enableJsonFlag": false,
8902
+ "promptFlagActive": true,
8903
+ "topic": "pg",
8904
+ "isESM": true,
8905
+ "relativePath": [
8906
+ "dist",
8907
+ "commands",
8908
+ "pg",
8909
+ "records-rank.js"
8910
+ ]
8911
+ },
8912
+ "pg:reset": {
8913
+ "aliases": [],
8914
+ "args": {
8915
+ "database": {
8916
+ "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
8917
+ "name": "database"
8918
+ }
8919
+ },
8920
+ "description": "delete all data in DATABASE",
8921
+ "flags": {
8922
+ "prompt": {
8923
+ "description": "interactively prompt for command arguments and flags",
8924
+ "helpGroup": "GLOBAL",
8925
+ "name": "prompt",
8926
+ "allowNo": false,
8927
+ "type": "boolean"
8928
+ },
8929
+ "app": {
8930
+ "char": "a",
8931
+ "description": "app to run command against",
8932
+ "name": "app",
8933
+ "required": true,
8934
+ "hasDynamicHelp": true,
8935
+ "multiple": false,
8936
+ "type": "option"
8937
+ },
8938
+ "confirm": {
8939
+ "char": "c",
8940
+ "name": "confirm",
8941
+ "hasDynamicHelp": false,
8942
+ "multiple": false,
8943
+ "type": "option"
8944
+ },
8945
+ "extensions": {
8946
+ "char": "e",
8947
+ "description": "comma-separated list of extensions to pre-install in the public schema",
8948
+ "name": "extensions",
8949
+ "hasDynamicHelp": false,
8950
+ "multiple": false,
8951
+ "type": "option"
8952
+ },
8953
+ "remote": {
8954
+ "char": "r",
8955
+ "description": "git remote of app to use",
8956
+ "name": "remote",
8957
+ "hasDynamicHelp": false,
8958
+ "multiple": false,
8959
+ "type": "option"
8960
+ }
8961
+ },
8962
+ "hasDynamicHelp": true,
8963
+ "hiddenAliases": [],
8964
+ "id": "pg:reset",
8965
+ "pluginAlias": "heroku",
8966
+ "pluginName": "heroku",
8967
+ "pluginType": "core",
8968
+ "strict": true,
8969
+ "enableJsonFlag": false,
8970
+ "promptFlagActive": true,
8971
+ "topic": "pg",
8972
+ "isESM": true,
8973
+ "relativePath": [
8974
+ "dist",
8975
+ "commands",
8976
+ "pg",
8977
+ "reset.js"
8978
+ ]
8979
+ },
8980
+ "pg:seq-scans": {
8981
+ "aliases": [],
8982
+ "args": {
8983
+ "database": {
8984
+ "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
8985
+ "name": "database",
8986
+ "required": false
8987
+ }
8988
+ },
8989
+ "description": "show the count of sequential scans by table descending by order",
8990
+ "examples": [
8991
+ "$ heroku pg:seq-scans --app example-app \n"
8992
+ ],
8993
+ "flags": {
8994
+ "prompt": {
8995
+ "description": "interactively prompt for command arguments and flags",
8996
+ "helpGroup": "GLOBAL",
8997
+ "name": "prompt",
8998
+ "allowNo": false,
8999
+ "type": "boolean"
9000
+ },
9001
+ "app": {
9002
+ "char": "a",
9003
+ "description": "app to run command against",
9004
+ "name": "app",
9005
+ "required": true,
9006
+ "hasDynamicHelp": true,
9007
+ "multiple": false,
9008
+ "type": "option"
9009
+ },
9010
+ "remote": {
9011
+ "char": "r",
9012
+ "description": "git remote of app to use",
9013
+ "name": "remote",
8198
9014
  "hasDynamicHelp": false,
8199
9015
  "multiple": false,
8200
9016
  "type": "option"
9017
+ }
9018
+ },
9019
+ "hasDynamicHelp": true,
9020
+ "hiddenAliases": [
9021
+ "pg:seq_scans"
9022
+ ],
9023
+ "id": "pg:seq-scans",
9024
+ "pluginAlias": "heroku",
9025
+ "pluginName": "heroku",
9026
+ "pluginType": "core",
9027
+ "strict": true,
9028
+ "enableJsonFlag": false,
9029
+ "promptFlagActive": true,
9030
+ "topic": "pg",
9031
+ "isESM": true,
9032
+ "relativePath": [
9033
+ "dist",
9034
+ "commands",
9035
+ "pg",
9036
+ "seq-scans.js"
9037
+ ]
9038
+ },
9039
+ "pg:stats-reset": {
9040
+ "aliases": [],
9041
+ "args": {
9042
+ "database": {
9043
+ "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
9044
+ "name": "database",
9045
+ "required": false
9046
+ }
9047
+ },
9048
+ "description": "calls the Postgres functions pg_stat_reset()",
9049
+ "examples": [
9050
+ "$ heroku pg:stats-reset --app example-app \n"
9051
+ ],
9052
+ "flags": {
9053
+ "prompt": {
9054
+ "description": "interactively prompt for command arguments and flags",
9055
+ "helpGroup": "GLOBAL",
9056
+ "name": "prompt",
9057
+ "allowNo": false,
9058
+ "type": "boolean"
8201
9059
  },
8202
- "file": {
8203
- "char": "f",
8204
- "description": "SQL file to run",
8205
- "name": "file",
8206
- "hasDynamicHelp": false,
9060
+ "app": {
9061
+ "char": "a",
9062
+ "description": "app to run command against",
9063
+ "name": "app",
9064
+ "required": true,
9065
+ "hasDynamicHelp": true,
8207
9066
  "multiple": false,
8208
9067
  "type": "option"
8209
9068
  },
@@ -8217,40 +9076,37 @@
8217
9076
  }
8218
9077
  },
8219
9078
  "hasDynamicHelp": true,
8220
- "hiddenAliases": [],
8221
- "id": "pg:psql",
9079
+ "hiddenAliases": [
9080
+ "pg:stats_reset"
9081
+ ],
9082
+ "id": "pg:stats-reset",
8222
9083
  "pluginAlias": "heroku",
8223
9084
  "pluginName": "heroku",
8224
9085
  "pluginType": "core",
8225
9086
  "strict": true,
8226
9087
  "enableJsonFlag": false,
8227
9088
  "promptFlagActive": true,
9089
+ "topic": "pg",
8228
9090
  "isESM": true,
8229
9091
  "relativePath": [
8230
9092
  "dist",
8231
9093
  "commands",
8232
9094
  "pg",
8233
- "psql.js"
9095
+ "stats-reset.js"
8234
9096
  ]
8235
9097
  },
8236
- "pg:pull": {
9098
+ "pg:table-indexes-size": {
8237
9099
  "aliases": [],
8238
9100
  "args": {
8239
- "source": {
9101
+ "database": {
8240
9102
  "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
8241
- "name": "source",
8242
- "required": true
8243
- },
8244
- "target": {
8245
- "description": "PostgreSQL connection string for the target database",
8246
- "name": "target",
8247
- "required": true
9103
+ "name": "database",
9104
+ "required": false
8248
9105
  }
8249
9106
  },
8250
- "description": "pull Heroku database into local or remote database\nPull from SOURCE into TARGET.\n\nTARGET must be one of:\n* a database name (i.e. on a local PostgreSQL server) => TARGET must not exist and will be created\n* a fully qualified URL to a local PostgreSQL server => TARGET must not exist and will be created\n* a fully qualified URL to a remote PostgreSQL server => TARGET must exist and be empty\n\nTo delete a local database run dropdb TARGET.\nTo create an empty remote database, run createdb with connection command-line options (run createdb --help for details).\n",
9107
+ "description": "show the total size of all the indexes on each table, descending by size",
8251
9108
  "examples": [
8252
- "# pull Heroku DB named postgresql-swimmingly-100 into local DB mylocaldb that must not exist\n $ heroku pg:pull postgresql-swimmingly-100 mylocaldb --app sushi \n",
8253
- "# pull Heroku DB named postgresql-swimmingly-100 into empty remote DB at postgres://myhost/mydb\n $ heroku pg:pull postgresql-swimmingly-100 postgres://myhost/mydb --app sushi \n"
9109
+ "$ heroku pg:table-indexes-size --app example-app \n"
8254
9110
  ],
8255
9111
  "flags": {
8256
9112
  "prompt": {
@@ -8269,13 +9125,6 @@
8269
9125
  "multiple": false,
8270
9126
  "type": "option"
8271
9127
  },
8272
- "exclude-table-data": {
8273
- "description": "tables for which data should be excluded (use ';' to split multiple names)",
8274
- "name": "exclude-table-data",
8275
- "hasDynamicHelp": false,
8276
- "multiple": false,
8277
- "type": "option"
8278
- },
8279
9128
  "remote": {
8280
9129
  "char": "r",
8281
9130
  "description": "git remote of app to use",
@@ -8286,8 +9135,10 @@
8286
9135
  }
8287
9136
  },
8288
9137
  "hasDynamicHelp": true,
8289
- "hiddenAliases": [],
8290
- "id": "pg:pull",
9138
+ "hiddenAliases": [
9139
+ "pg:table_indexes_size"
9140
+ ],
9141
+ "id": "pg:table-indexes-size",
8291
9142
  "pluginAlias": "heroku",
8292
9143
  "pluginName": "heroku",
8293
9144
  "pluginType": "core",
@@ -8300,27 +9151,23 @@
8300
9151
  "dist",
8301
9152
  "commands",
8302
9153
  "pg",
8303
- "pull.js"
9154
+ "table-indexes-size.js"
8304
9155
  ]
8305
9156
  },
8306
- "pg:push": {
8307
- "aliases": [],
9157
+ "pg:table-size": {
9158
+ "aliases": [
9159
+ "pg:table_size"
9160
+ ],
8308
9161
  "args": {
8309
- "source": {
8310
- "description": "PostgreSQL connection string for the source database",
8311
- "name": "source",
8312
- "required": true
8313
- },
8314
- "target": {
9162
+ "database": {
8315
9163
  "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
8316
- "name": "target",
8317
- "required": true
9164
+ "name": "database",
9165
+ "required": false
8318
9166
  }
8319
9167
  },
8320
- "description": "push local or remote into Heroku database\nPush from SOURCE into TARGET. TARGET must be empty.\n\nTo empty a Heroku database for push run heroku pg:reset\n\nSOURCE must be either the name of a database existing on your localhost or the\nfully qualified URL of a remote database.\n",
9168
+ "description": "show the size of the tables (excluding indexes), descending by size",
8321
9169
  "examples": [
8322
- "# push mylocaldb into a Heroku DB named postgresql-swimmingly-100\n$ heroku pg:push mylocaldb postgresql-swimmingly-100 --app sushi\n",
8323
- "# push remote DB at postgres://myhost/mydb into a Heroku DB named postgresql-swimmingly-100\n$ heroku pg:push postgres://myhost/mydb postgresql-swimmingly-100 --app sushi\n"
9170
+ "$ heroku pg:table-size --app example-app \n"
8324
9171
  ],
8325
9172
  "flags": {
8326
9173
  "prompt": {
@@ -8339,13 +9186,6 @@
8339
9186
  "multiple": false,
8340
9187
  "type": "option"
8341
9188
  },
8342
- "exclude-table-data": {
8343
- "description": "tables for which data should be excluded (use ';' to split multiple names)",
8344
- "name": "exclude-table-data",
8345
- "hasDynamicHelp": false,
8346
- "multiple": false,
8347
- "type": "option"
8348
- },
8349
9189
  "remote": {
8350
9190
  "char": "r",
8351
9191
  "description": "git remote of app to use",
@@ -8357,7 +9197,7 @@
8357
9197
  },
8358
9198
  "hasDynamicHelp": true,
8359
9199
  "hiddenAliases": [],
8360
- "id": "pg:push",
9200
+ "id": "pg:table-size",
8361
9201
  "pluginAlias": "heroku",
8362
9202
  "pluginName": "heroku",
8363
9203
  "pluginType": "core",
@@ -8370,18 +9210,22 @@
8370
9210
  "dist",
8371
9211
  "commands",
8372
9212
  "pg",
8373
- "push.js"
9213
+ "table-size.js"
8374
9214
  ]
8375
9215
  },
8376
- "pg:reset": {
9216
+ "pg:total-index-size": {
8377
9217
  "aliases": [],
8378
9218
  "args": {
8379
9219
  "database": {
8380
9220
  "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
8381
- "name": "database"
9221
+ "name": "database",
9222
+ "required": false
8382
9223
  }
8383
9224
  },
8384
- "description": "delete all data in DATABASE",
9225
+ "description": "show the total size of all indexes in MB",
9226
+ "examples": [
9227
+ "$ heroku pg:total-index-size --app example-app \n"
9228
+ ],
8385
9229
  "flags": {
8386
9230
  "prompt": {
8387
9231
  "description": "interactively prompt for command arguments and flags",
@@ -8399,18 +9243,64 @@
8399
9243
  "multiple": false,
8400
9244
  "type": "option"
8401
9245
  },
8402
- "confirm": {
8403
- "char": "c",
8404
- "name": "confirm",
9246
+ "remote": {
9247
+ "char": "r",
9248
+ "description": "git remote of app to use",
9249
+ "name": "remote",
8405
9250
  "hasDynamicHelp": false,
8406
9251
  "multiple": false,
8407
9252
  "type": "option"
9253
+ }
9254
+ },
9255
+ "hasDynamicHelp": true,
9256
+ "hiddenAliases": [
9257
+ "pg:total_index_size"
9258
+ ],
9259
+ "id": "pg:total-index-size",
9260
+ "pluginAlias": "heroku",
9261
+ "pluginName": "heroku",
9262
+ "pluginType": "core",
9263
+ "strict": true,
9264
+ "enableJsonFlag": false,
9265
+ "promptFlagActive": true,
9266
+ "topic": "pg",
9267
+ "isESM": true,
9268
+ "relativePath": [
9269
+ "dist",
9270
+ "commands",
9271
+ "pg",
9272
+ "total-index-size.js"
9273
+ ]
9274
+ },
9275
+ "pg:total-table-size": {
9276
+ "aliases": [
9277
+ "pg:total_table_size"
9278
+ ],
9279
+ "args": {
9280
+ "database": {
9281
+ "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
9282
+ "name": "database",
9283
+ "required": false
9284
+ }
9285
+ },
9286
+ "description": "show the size of the tables (including indexes), descending by size",
9287
+ "examples": [
9288
+ "$ heroku pg:total-table-size --app example-app \n"
9289
+ ],
9290
+ "flags": {
9291
+ "prompt": {
9292
+ "description": "interactively prompt for command arguments and flags",
9293
+ "helpGroup": "GLOBAL",
9294
+ "name": "prompt",
9295
+ "allowNo": false,
9296
+ "type": "boolean"
8408
9297
  },
8409
- "extensions": {
8410
- "char": "e",
8411
- "description": "comma-separated list of extensions to pre-install in the public schema",
8412
- "name": "extensions",
8413
- "hasDynamicHelp": false,
9298
+ "app": {
9299
+ "char": "a",
9300
+ "description": "app to run command against",
9301
+ "name": "app",
9302
+ "required": true,
9303
+ "hasDynamicHelp": true,
8414
9304
  "multiple": false,
8415
9305
  "type": "option"
8416
9306
  },
@@ -8425,7 +9315,7 @@
8425
9315
  },
8426
9316
  "hasDynamicHelp": true,
8427
9317
  "hiddenAliases": [],
8428
- "id": "pg:reset",
9318
+ "id": "pg:total-table-size",
8429
9319
  "pluginAlias": "heroku",
8430
9320
  "pluginName": "heroku",
8431
9321
  "pluginType": "core",
@@ -8438,7 +9328,7 @@
8438
9328
  "dist",
8439
9329
  "commands",
8440
9330
  "pg",
8441
- "reset.js"
9331
+ "total-table-size.js"
8442
9332
  ]
8443
9333
  },
8444
9334
  "pg:unfollow": {
@@ -8502,6 +9392,124 @@
8502
9392
  "unfollow.js"
8503
9393
  ]
8504
9394
  },
9395
+ "pg:unused-indexes": {
9396
+ "aliases": [
9397
+ "pg:unused_indexes"
9398
+ ],
9399
+ "args": {
9400
+ "database": {
9401
+ "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
9402
+ "name": "database",
9403
+ "required": false
9404
+ }
9405
+ },
9406
+ "description": "show unused and almost unused indexes",
9407
+ "examples": [
9408
+ "$ heroku pg:unused-indexes --app example-app \n"
9409
+ ],
9410
+ "flags": {
9411
+ "prompt": {
9412
+ "description": "interactively prompt for command arguments and flags",
9413
+ "helpGroup": "GLOBAL",
9414
+ "name": "prompt",
9415
+ "allowNo": false,
9416
+ "type": "boolean"
9417
+ },
9418
+ "app": {
9419
+ "char": "a",
9420
+ "description": "app to run command against",
9421
+ "name": "app",
9422
+ "required": true,
9423
+ "hasDynamicHelp": true,
9424
+ "multiple": false,
9425
+ "type": "option"
9426
+ },
9427
+ "remote": {
9428
+ "char": "r",
9429
+ "description": "git remote of app to use",
9430
+ "name": "remote",
9431
+ "hasDynamicHelp": false,
9432
+ "multiple": false,
9433
+ "type": "option"
9434
+ }
9435
+ },
9436
+ "hasDynamicHelp": true,
9437
+ "hiddenAliases": [],
9438
+ "id": "pg:unused-indexes",
9439
+ "pluginAlias": "heroku",
9440
+ "pluginName": "heroku",
9441
+ "pluginType": "core",
9442
+ "strict": true,
9443
+ "enableJsonFlag": false,
9444
+ "promptFlagActive": true,
9445
+ "topic": "pg",
9446
+ "isESM": true,
9447
+ "relativePath": [
9448
+ "dist",
9449
+ "commands",
9450
+ "pg",
9451
+ "unused-indexes.js"
9452
+ ]
9453
+ },
9454
+ "pg:user-connections": {
9455
+ "aliases": [],
9456
+ "args": {
9457
+ "database": {
9458
+ "description": "config var containing the connection string, unique name, ID, or alias of the database. To access another app's database, prepend the app name to the config var or alias with `APP_NAME::` . If omitted, we use DATABASE_URL.",
9459
+ "name": "database",
9460
+ "required": false
9461
+ }
9462
+ },
9463
+ "description": "returns the number of connections per credential",
9464
+ "examples": [
9465
+ "$ heroku pg:user-connections --app example-app \n"
9466
+ ],
9467
+ "flags": {
9468
+ "prompt": {
9469
+ "description": "interactively prompt for command arguments and flags",
9470
+ "helpGroup": "GLOBAL",
9471
+ "name": "prompt",
9472
+ "allowNo": false,
9473
+ "type": "boolean"
9474
+ },
9475
+ "app": {
9476
+ "char": "a",
9477
+ "description": "app to run command against",
9478
+ "name": "app",
9479
+ "required": true,
9480
+ "hasDynamicHelp": true,
9481
+ "multiple": false,
9482
+ "type": "option"
9483
+ },
9484
+ "remote": {
9485
+ "char": "r",
9486
+ "description": "git remote of app to use",
9487
+ "name": "remote",
9488
+ "hasDynamicHelp": false,
9489
+ "multiple": false,
9490
+ "type": "option"
9491
+ }
9492
+ },
9493
+ "hasDynamicHelp": true,
9494
+ "hiddenAliases": [
9495
+ "pg:user_connections"
9496
+ ],
9497
+ "id": "pg:user-connections",
9498
+ "pluginAlias": "heroku",
9499
+ "pluginName": "heroku",
9500
+ "pluginType": "core",
9501
+ "strict": true,
9502
+ "enableJsonFlag": false,
9503
+ "promptFlagActive": true,
9504
+ "topic": "pg",
9505
+ "isESM": true,
9506
+ "relativePath": [
9507
+ "dist",
9508
+ "commands",
9509
+ "pg",
9510
+ "user-connections.js"
9511
+ ]
9512
+ },
8505
9513
  "pg:vacuum-stats": {
8506
9514
  "aliases": [],
8507
9515
  "args": {
@@ -19727,5 +20735,5 @@
19727
20735
  ]
19728
20736
  }
19729
20737
  },
19730
- "version": "11.6.0"
20738
+ "version": "11.7.0"
19731
20739
  }