Skip to content

Conversation

jseldess
Copy link
Contributor

@jseldess jseldess commented Feb 1, 2017

This PR adds the MAX_INDEX_KEYS, SEARCH_PATH, and SERVER_VERSION variables to the SHOW ALL statement documentation. Fixes #933. Fixes #790.

It also changes the Develop sidebar a bit:

  • New subsection called SQL Syntax to better house topics like constants, keywords, expressions, and the full grammar.
  • Moved SQL Feature Support from Learn How It Works to Develop for greater visibility.

@knz, the addition of search_path to the show all docs goes well with your PR on name resolution. I'll get that reviewed in the morning. If we merge that first, I can link to those docs from the search_path description on the show all page.


This change is Reviewable

@cockroach-teamcity
Copy link
Member

show-all.md Outdated
`DATABASE` | The default database for the current session, as set by [`SET DATABASE`](set-database.html) or the client's connection string. This variable can be viewed with [`SHOW DATABASE`](show-database.html) as well.
`DEFAULT_TRANSACTION_ISOLATION` | The default transaction isolation level for the current session, as set by `SET DEFAULT_TRANSACTION_ISOLATION` or the client's connection string.
`MAX_INDEX_KEYS` | Not usable; exposed only for ORM compatibility.
`SEARCH_PATH` | A list of databases or name spaces that will be searched to resolve unqualified table or function names. This variable can be changed with `SET SEARCH_PATH`.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Namespaces should be a single word.

Also, we don't actually support changing this with SET, so I would drop the last sentence.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done.

show-all.md Outdated
`DEFAULT_TRANSACTION_ISOLATION` | The default transaction isolation level for the current session, as set by `SET DEFAULT_TRANSACTION_ISOLATION` or the client's connection string.
`MAX_INDEX_KEYS` | Not usable; exposed only for ORM compatibility.
`SEARCH_PATH` | A list of databases or name spaces that will be searched to resolve unqualified table or function names. This variable can be changed with `SET SEARCH_PATH`.
`SERVER_VERSION` | The latest version of PostgreSQL that CockroachDB is compatible with.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm starting to doubt that "compatible with" is the correct phrasing, and I would drop the word "latest". This is the version of Postgres that we try to emulate. Perhaps "implement"?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done.

@cockroach-teamcity
Copy link
Member

@knz
Copy link
Contributor

knz commented Feb 1, 2017

LGTM

@nvb
Copy link
Contributor

nvb commented Feb 1, 2017

LGTM

@cockroach-teamcity
Copy link
Member

@jseldess jseldess merged commit c712cdc into gh-pages Feb 1, 2017
@jseldess jseldess deleted the show-all-updates branch February 1, 2017 22:57
Simran-B added a commit to Simran-B/docs that referenced this pull request Aug 21, 2025
* Add loading state

* Documented missing states 'none' and 'fatal error'

Additionally, reordered states based on occurance during a run
and relevance for the user.

* Review

* Fix link

* Update examples for 3.10 in feature/add-loading-state-to-list-of-pregel-states at 2022-08-11T15:39:29+02:00

* Fix 3-way merge mistakes

Co-authored-by: Simran Spiller <simran@arangodb.com>
Co-authored-by: ansoboleva <93702078+ansoboleva@users.noreply.github.com>
Co-authored-by: arangodb-release-bot <anastasia.soboleva@arangodb.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants