Skip to content

Commit

Permalink
vy-ton and RichardJCai feedback
Browse files Browse the repository at this point in the history
  • Loading branch information
@ericharmeling
ericharmeling committed Mar 18, 2021
1 parent 14cd8dc commit 02f99fc
Show file tree
Hide file tree
Showing 16 changed files with 282 additions and 285 deletions.
140 changes: 70 additions & 70 deletions _includes/sidebar-data-v20.2.json
View file
Original file line number Diff line number Diff line change
Expand Up @@ -1190,12 +1190,6 @@
"/${VERSION}/sql-feature-support.html"
]
},
{
"title": "Name Resolution",
"urls": [
"/${VERSION}/sql-name-resolution.html"
]
},
{
"title": "SQL Statements",
"items": [
Expand Down Expand Up @@ -2200,6 +2194,47 @@
}
]
},
{
"title": "Name Resolution",
"urls": [
"/${VERSION}/sql-name-resolution.html"
]
},
{
"title": "System Catalogs",
"items": [
{
"title": "Overview",
"urls": [
"/${VERSION}/system-catalogs.html"
]
},
{
"title": "<code>crdb_internal</code>",
"urls": [
"/${VERSION}/crdb-internal.html"
]
},
{
"title": "<code>information_schema</code>",
"urls": [
"/${VERSION}/information-schema.html"
]
},
{
"title": "<code>pg_catalog</code>",
"urls": [
"/${VERSION}/pg-catalog.html"
]
},
{
"title": "<code>pg_extension</code>",
"urls": [
"/${VERSION}/pg-extension.html"
]
}
]
},
{
"title": "Transactions",
"items": [
Expand All @@ -2223,6 +2258,35 @@
}
]
},
{
"title": "Performance Optimization",
"items": [
{
"title": "Indexes",
"urls": [
"/${VERSION}/indexes.html"
]
},
{
"title": "Interleaved Tables",
"urls": [
"/${VERSION}/interleave-in-parent.html"
]
},
{
"title": "Cost-Based Optimizer",
"urls": [
"/${VERSION}/cost-based-optimizer.html"
]
},
{
"title": "Vectorized Execution",
"urls": [
"/${VERSION}/vectorized-execution.html"
]
}
]
},
{
"title": "Spatial Features",
"items": [
Expand Down Expand Up @@ -2384,70 +2448,6 @@
}
]
},
{
"title": "Performance Optimization",
"items": [
{
"title": "Indexes",
"urls": [
"/${VERSION}/indexes.html"
]
},
{
"title": "Interleaved Tables",
"urls": [
"/${VERSION}/interleave-in-parent.html"
]
},
{
"title": "Cost-Based Optimizer",
"urls": [
"/${VERSION}/cost-based-optimizer.html"
]
},
{
"title": "Vectorized Execution",
"urls": [
"/${VERSION}/vectorized-execution.html"
]
}
]
},
{
"title": "Virtual Schemas",
"items": [
{
"title": "Overview",
"urls": [
"/${VERSION}/virtual-schemas.html"
]
},
{
"title": "<code>crdb_internal</code>",
"urls": [
"/${VERSION}/crdb-internal.html"
]
},
{
"title": "<code>information_schema</code>",
"urls": [
"/${VERSION}/information-schema.html"
]
},
{
"title": "<code>pg_catalog</code>",
"urls": [
"/${VERSION}/pg-catalog.html"
]
},
{
"title": "<code>pg_extension</code>",
"urls": [
"/${VERSION}/pg-extension.html"
]
}
]
},
{
"title": "Experimental Features",
"urls": [
Expand Down
141 changes: 71 additions & 70 deletions _includes/sidebar-data-v21.1.json
View file
Original file line number Diff line number Diff line change
Expand Up @@ -1219,12 +1219,6 @@
"/${VERSION}/sql-feature-support.html"
]
},
{
"title": "Name Resolution",
"urls": [
"/${VERSION}/sql-name-resolution.html"
]
},
{
"title": "SQL Statements",
"items": [
Expand Down Expand Up @@ -2229,6 +2223,48 @@
}
]
},

{
"title": "Name Resolution",
"urls": [
"/${VERSION}/sql-name-resolution.html"
]
},
{
"title": "System Catalogs",
"items": [
{
"title": "Overview",
"urls": [
"/${VERSION}/system-catalogs.html"
]
},
{
"title": "<code>crdb_internal</code>",
"urls": [
"/${VERSION}/crdb-internal.html"
]
},
{
"title": "<code>information_schema</code>",
"urls": [
"/${VERSION}/information-schema.html"
]
},
{
"title": "<code>pg_catalog</code>",
"urls": [
"/${VERSION}/pg-catalog.html"
]
},
{
"title": "<code>pg_extension</code>",
"urls": [
"/${VERSION}/pg-extension.html"
]
}
]
},
{
"title": "Transactions",
"items": [
Expand All @@ -2252,6 +2288,35 @@
}
]
},
{
"title": "Performance Optimization",
"items": [
{
"title": "Indexes",
"urls": [
"/${VERSION}/indexes.html"
]
},
{
"title": "Interleaved Tables",
"urls": [
"/${VERSION}/interleave-in-parent.html"
]
},
{
"title": "Cost-Based Optimizer",
"urls": [
"/${VERSION}/cost-based-optimizer.html"
]
},
{
"title": "Vectorized Execution",
"urls": [
"/${VERSION}/vectorized-execution.html"
]
}
]
},
{
"title": "Spatial Features",
"items": [
Expand Down Expand Up @@ -2413,70 +2478,6 @@
}
]
},
{
"title": "Performance Optimization",
"items": [
{
"title": "Indexes",
"urls": [
"/${VERSION}/indexes.html"
]
},
{
"title": "Interleaved Tables",
"urls": [
"/${VERSION}/interleave-in-parent.html"
]
},
{
"title": "Cost-Based Optimizer",
"urls": [
"/${VERSION}/cost-based-optimizer.html"
]
},
{
"title": "Vectorized Execution",
"urls": [
"/${VERSION}/vectorized-execution.html"
]
}
]
},
{
"title": "Virtual Schemas",
"items": [
{
"title": "Overview",
"urls": [
"/${VERSION}/virtual-schemas.html"
]
},
{
"title": "<code>crdb_internal</code>",
"urls": [
"/${VERSION}/crdb-internal.html"
]
},
{
"title": "<code>information_schema</code>",
"urls": [
"/${VERSION}/information-schema.html"
]
},
{
"title": "<code>pg_catalog</code>",
"urls": [
"/${VERSION}/pg-catalog.html"
]
},
{
"title": "<code>pg_extension</code>",
"urls": [
"/${VERSION}/pg-extension.html"
]
}
]
},
{
"title": "Experimental Features",
"urls": [
Expand Down
6 changes: 3 additions & 3 deletions v20.2/crdb-internal.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -4,11 +4,11 @@ summary: The crdb_internal schema contains read-only views that you can use for
toc: true
---

The `crdb_internal` [virtual schema](virtual-schemas.html) contains information about internal objects, processes, and metrics related to a specific database.
The `crdb_internal` [system catalog](system-catalogs.html) is a schema that contains information about internal objects, processes, and metrics related to a specific database.

{{site.data.alerts.callout_danger}}
We do not recommend using `crdb_internal` tables in production environments for the following reasons:
- The contents of `crdb_internal` are unstable, and subject to change in new releases of CockroachDB.
- The contents of `crdb_internal` are unstable, and subject to change in new releases of CockroachDB, without prior notice.
- There are memory and latency costs associated with each table in `crdb_internal`. Accessing the tables in the schema can impact cluster stability and performance.
{{site.data.alerts.end}}

Expand Down Expand Up @@ -120,4 +120,4 @@ For example, to return the `crdb_internal` table for the ranges of the [`movr`](
- [`SHOW SCHEMAS`](show-schemas.html)
- [`SHOW TABLES`](show-tables.html)
- [SQL Name Resolution](sql-name-resolution.html)
- [Virtual Schemas](virtual-schemas.html)
- [System Catalogs](system-catalogs.html)
8 changes: 3 additions & 5 deletions v20.2/information-schema.md
View file
Original file line number Diff line number Diff line change
@@ -1,12 +1,10 @@
---
title: information_schema
summary: The information_schema virtual schema contains read-only views that you can use for introspection into your database's tables, columns, indexes, and views.
summary: The information_schema schema contains read-only views that you can use for introspection into your database's tables, columns, indexes, and views.
toc: true
---

The `information_schema` [virtual schema](virtual-schemas.html) contains information about your database's tables, columns, indexes, and views. This information can be used for introspection and reflection.

The definition of `information_schema` is part of the SQL standard and can therefore be relied on to remain stable over time. This contrasts with CockroachDB's `SHOW` statements, which provide similar data and are meant to be stable in CockroachDB but not standardized. It also contrasts with the virtual schema [`crdb_internal`](crdb-internal.html), which reflects the internals of CockroachDB and may thus change across CockroachDB versions.
The `information_schema` [system catalog](system-catalogs.html) contains information about your database's tables, columns, indexes, and views. This information can be used for introspection and reflection.

## Data exposed by `information_schema`

Expand Down Expand Up @@ -414,7 +412,7 @@ And to retrieve specific columns from the `table_constraints` table:

## See also

- [Virtual Schemas](virtual-schemas.html)
- [System Catalogs](system-catalogs.html)
- [`SHOW`](show-vars.html)
- [`SHOW COLUMNS`](show-columns.html)
- [`SHOW CONSTRAINTS`](show-constraints.html)
Expand Down
Loading

0 comments on commit 02f99fc

Please sign in to comment.