Skip to content

ps-10186-8.0 - [DOCS] - Document performance_schema.account_failed_lo… #572

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: 8.0
Choose a base branch
from
Open

ps-10186-8.0 - [DOCS] - Document performance_schema.account_failed_lo… #572

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
48 changes: 24 additions & 24 deletions docs/misc-info-schema-tables.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Misc. INFORMATION_SCHEMA tables

This page lists the `INFORMATION_SCHEMA` tables added to standard *MySQL* by *Percona Server for MySQL* that don’t exist elsewhere in the documentation.
This page lists the `INFORMATION_SCHEMA` tables added to standard *MySQL* by *Percona Server for MySQL* that don't exist elsewhere in the documentation.

## Temporary tables

Expand All @@ -14,37 +14,37 @@ Only the temporary tables that were explicitly created with CREATE TEMPORARY TAB

| Column Name | Description |
|------------------|-------------------------------------------------------------|
| ‘SESSION_ID’ | ‘MySQL connection id’ |
| ‘TABLE_SCHEMA’ | ‘Schema in which the temporary table is created’ |
| ‘TABLE_NAME’ | ‘Name of the temporary table’ |
| ‘ENGINE’ | ‘Engine of the temporary table’ |
| ‘NAME’ | ‘Internal name of the temporary table’ |
| ‘TABLE_ROWS’ | ‘Number of rows of the temporary table’ |
| ‘AVG_ROW_LENGTH’ | ‘Average row length of the temporary table’ |
| ‘DATA_LENGTH’ | ‘Size of the data (Bytes)’ |
| ‘INDEX_LENGTH’ | ‘Size of the indexes (Bytes)’ |
| ‘CREATE_TIME’ | ‘Date and time of creation of the temporary table’ |
| ‘UPDATE_TIME’ | ‘Date and time of the latest update of the temporary table’ |
| 'SESSION_ID' | 'MySQL connection id' |
| 'TABLE_SCHEMA' | 'Schema in which the temporary table is created' |
| 'TABLE_NAME' | 'Name of the temporary table' |
| 'ENGINE' | 'Engine of the temporary table' |
| 'NAME' | 'Internal name of the temporary table' |
| 'TABLE_ROWS' | 'Number of rows of the temporary table' |
| 'AVG_ROW_LENGTH' | 'Average row length of the temporary table' |
| 'DATA_LENGTH' | 'Size of the data (Bytes)' |
| 'INDEX_LENGTH' | 'Size of the indexes (Bytes)' |
| 'CREATE_TIME' | 'Date and time of creation of the temporary table' |
| 'UPDATE_TIME' | 'Date and time of the latest update of the temporary table' |

The feature was ported from *Percona Server for MySQL* 5.7 in 8.0.12-1.

This table holds information on the temporary tables that exist for all connections. You don’t need the `SUPER` privilege to query this table.
This table holds information on the temporary tables that exist for all connections. You don't need the `SUPER` privilege to query this table.

### `INFORMATION_SCHEMA.TEMPORARY_TABLES`

| Column Name | Description |
|------------------|-------------------------------------------------------------|
| ‘SESSION_ID’ | ‘MySQL connection id’ |
| ‘TABLE_SCHEMA’ | ‘Schema in which the temporary table is created’ |
| ‘TABLE_NAME’ | ‘Name of the temporary table’ |
| ‘ENGINE’ | ‘Engine of the temporary table’ |
| ‘NAME’ | ‘Internal name of the temporary table’ |
| ‘TABLE_ROWS’ | ‘Number of rows of the temporary table’ |
| ‘AVG_ROW_LENGTH’ | ‘Average row length of the temporary table’ |
| ‘DATA_LENGTH’ | ‘Size of the data (Bytes)’ |
| ‘INDEX_LENGTH’ | ‘Size of the indexes (Bytes)’ |
| ‘CREATE_TIME’ | ‘Date and time of creation of the temporary table’ |
| ‘UPDATE_TIME’ | ‘Date and time of the latest update of the temporary table’ |
| 'SESSION_ID' | 'MySQL connection id' |
| 'TABLE_SCHEMA' | 'Schema in which the temporary table is created' |
| 'TABLE_NAME' | 'Name of the temporary table' |
| 'ENGINE' | 'Engine of the temporary table' |
| 'NAME' | 'Internal name of the temporary table' |
| 'TABLE_ROWS' | 'Number of rows of the temporary table' |
| 'AVG_ROW_LENGTH' | 'Average row length of the temporary table' |
| 'DATA_LENGTH' | 'Size of the data (Bytes)' |
| 'INDEX_LENGTH' | 'Size of the indexes (Bytes)' |
| 'CREATE_TIME' | 'Date and time of creation of the temporary table' |
| 'UPDATE_TIME' | 'Date and time of the latest update of the temporary table' |

The feature was ported from *Percona Server for MySQL* 5.7 in 8.0.12-1.

Expand Down
22 changes: 22 additions & 0 deletions docs/misc-performance-schema-tables.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
# Misc. Performance Schema tables

This page lists the `performance_schema` tables added to standard *MySQL* by *Percona Server for MySQL* that don't exist elsewhere in the documentation.

## Performance schema tables

### `performance_schema.account_failed_login_lock_status`

The new `performance_schema.account_failed_login_lock_status` table is implemented in Percona Server for MySQL 8.0.44-35 and exposes information about temporary account locking from MySQL internal Access Control List (ACL) cache.

This table is read-only, and global, per-database or per-table `SELECT` privilege on this table are required from users who want to access the table contents.

| Column Name | Data Type | Description |
|--------------------------|---------------------|------------------------------------------------------------------------------------------------------------------------------------------------|
| `USER` | `CHAR(..)` | Identifies the user account described by the table row |
| `HOST` | `CHAR(..)` | Identifies the user account described by the table row |
| `IS_TRACKING_ACTIVE` | `enum('YES','NO')` | Indicates whether failed login tracking is enabled for the account |
| `MAX_ATTEMPTS` | `INTEGER` | Maximum number of failed login attempts allowed before account is locked (corresponds to FAILED_LOGIN_ATTEMPTS clause value in CREATE USER statement) |
| `PASSWORD_LOCK_DAYS` | `INTEGER` | Number of days for which account will be temporarily locked after exceeding the MAX_ATTEMPS limit. Set to -1 if account is locked forever (corresponds to PASSWORD_LOCK_TIME clause value in CREATE USER) |
| `IS_LOCKED` | `BOOLEAN` | Indicates if account is temporarily locked by failed login lock tracking. NULL if tracking is not enabled for account |
Copy link
Collaborator

Choose a reason for hiding this comment

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

I think it is worth emphasizing that the contents of this field has no relation to account locking not related to failed login attempt tracking. E.g. by adding something like: "Please note that if the account is locked using CREATE USER or ALTER TABLE statements with ACCOUNT LOCK clause, and not due to failed login lock tracking, this fact won't be reflected in this column. One should look at account_locked column in mysql.users table to see this instead".
What do you think?

| `REMAINING_ATTEMPTS` | `INTEGER` | Number of failed login attempts remaining before account will be locked. NULL if tracking is not enabled for account |
| `REMAINING_DAYS_LOCKED` | `INTEGER` | Number of days for which account is locked due to failed login lock tracking. -1 means that account is locked "forever" (until server restart/FLUSH PRIVILEGES or specific account unlock). NULL if tracking is not enabled for account |
2 changes: 2 additions & 0 deletions mkdocs-base.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -372,6 +372,8 @@ nav:
- audit-log-plugin.md
- jemalloc-profiling.md
- misc-info-schema-tables.md
- misc-performance-schema-tables.md

- process-list.md
- Slow query log:
- improved-slow-query-log.md
Expand Down
Loading