> For the complete documentation index, see [llms.txt](https://mariadb.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mariadb.com/docs/server/reference/system-tables/sys-schema/sys-schema-views/schema_auto_increment_columns-sys-schema-view.md).

# schema\_auto\_increment\_columns Sys Schema View

{% hint style="info" %}
Sys Schema views are available from MariaDB 10.6.
{% endhint %}

## Description

Information about [AUTO\_INCREMENT](/docs/server/reference/data-types/auto_increment.md) columns, sorted by descending usage ratio and maximum column value. Does not include columns in the `mysql`, `sys`, `information_schema` and `performance_schema` schemas.

Contains the following columns:

| Column                 | Description                                                                                                                                                              |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| table\_schema          | Schema name containing the table with the auto\_increment attribute.                                                                                                     |
| table\_name            | Table containing the auto\_increment attribute.                                                                                                                          |
| column\_name           | Name of the column containing the auto\_increment attribute.                                                                                                             |
| data\_type             | [Data type](/docs/server/reference/data-types.md) of the auto\_increment column, for example [tinyint](/docs/server/reference/data-types/numeric-data-types/tinyint.md). |
| column\_type           | [Data type](/docs/server/reference/data-types.md) of the auto\_increment column, plus additional information for example tinyint(3) unsigned.                            |
| is\_signed             | 1 if the column is [signed](/docs/server/reference/data-types/numeric-data-types/numeric-data-type-overview.md#signed-unsigned-and-zerofill),0 if not.                   |
| is\_unsigned           | 1 if the column is unsigned,0 if it is.                                                                                                                                  |
| max\_value             | Maximum possible value for the column, for example 255 for an unsigned tinyint.                                                                                          |
| auto\_increment        | Current auto\_increment value for the column.                                                                                                                            |
| auto\_increment\_ratio | Ratio of used to maximum value for the auto\_increment column.                                                                                                           |

## Example

```sql
CREATE OR REPLACE TABLE animals (
    id TINYINT NOT NULL AUTO_INCREMENT,
    name CHAR(30) NOT NULL,
    PRIMARY KEY (id)
);

 INSERT INTO animals (name) VALUES
    ('dog'),('cat'),('penguin'),
    ('fox'),('whale'),('ostrich');

SELECT * FROM sys.schema_auto_increment_columns\G
*************************** 1. row ***************************
        table_schema: test
          table_name: animals
         column_name: id
           data_type: tinyint
         column_type: tinyint(4)
           is_signed: 1
         is_unsigned: 0
           max_value: 127
      auto_increment: 7
auto_increment_ratio: 0.0551
```

<sub>*This page is licensed: CC BY-SA / Gnu FDL*</sub>

{% @marketo/form formId="4316" %}
