Add restrictions to 'Tables' schema.

Signed-off-by: Bradley Grainger <bgrainger@gmail.com>

Author: bgrainger

docs/content/overview/schema-collections.md

@@ -1,6 +1,6 @@
 ---
 date: 2021-04-24
-lastmod: 2022-07-11
+lastmod: 2022-08-12
 menu:
   main:
     parent: getting started
@@ -37,7 +37,7 @@ weight: 80
 * `ResourceGroups`
 * `Restrictions`—[information about the restrictions supported when retrieving schemas](../schema/restrictions/)
 * `SchemaPrivileges`
-* `Tables`
+* `Tables`—[information about tables](../schema/tables/)
 * `TableConstraints`
 * `TablePrivileges`
 * `TableSpaces`

docs/content/overview/schema/tables.md

@@ -0,0 +1,43 @@
+---
+date: 2022-07-10
+lastmod: 2022-08-12
+title: Tables Schema
+---
+
+# Tables Schema
+
+The `Tables` schema provides information about tables.
+
+Column Name | Data Type | Description
+--- | --- | ---
+TABLE_CATALOG | string | 
+TABLE_SCHEMA | string | 
+TABLE_NAME | string | 
+TABLE_TYPE | string | 
+ENGINE | string | 
+VERSION | string | 
+ROW_FORMAT | string | 
+TABLE_ROWS | long | 
+AVG_ROW_LENGTH | long | 
+DATA_LENGTH | long | 
+MAX_DATA_LENGTH | long | 
+INDEX_LENGTH | long | 
+DATA_FREE | long | 
+AUTO_INCREMENT | long | 
+CREATE_TIME | DateTime | 
+UPDATE_TIME | DateTime | 
+CHECK_TIME | DateTime | 
+TABLE_COLLATION | string | 
+CHECKSUM | string | 
+CREATE_OPTIONS | string | 
+TABLE_COMMENT | string | 
+
+The following restrictions are supported:
+
+Restriction Name | Restriction Default | Restriction Number
+--- | --- | --:
+Catalog | TABLE_CATALOG | 1
+Schema | TABLE_SCHEMA | 2
+Table | TABLE_NAME | 3
+TableType | TABLE_TYPE | 4
+

src/MySqlConnector/Core/SchemaProvider.g.cs

@@ -111,7 +111,7 @@ private Task FillMetaDataCollectionsAsync(IOBehavior ioBehavior, DataTable dataT
 		dataTable.Rows.Add("ResourceGroups", 0, 0);
 		dataTable.Rows.Add("Restrictions", 0, 0);
 		dataTable.Rows.Add("SchemaPrivileges", 0, 0);
-		dataTable.Rows.Add("Tables", 0, 3);
+		dataTable.Rows.Add("Tables", 4, 3);
 		dataTable.Rows.Add("TableConstraints", 0, 3);
 		dataTable.Rows.Add("TablePrivileges", 0, 0);
 		dataTable.Rows.Add("TableSpaces", 0, 0);
@@ -599,6 +599,10 @@ private Task FillRestrictionsAsync(IOBehavior ioBehavior, DataTable dataTable, s
 		dataTable.Rows.Add("Columns", "Schema", "TABLE_SCHEMA", 2);
 		dataTable.Rows.Add("Columns", "Table", "TABLE_NAME", 3);
 		dataTable.Rows.Add("Columns", "Column", "COLUMN_NAME", 4);
+		dataTable.Rows.Add("Tables", "Catalog", "TABLE_CATALOG", 1);
+		dataTable.Rows.Add("Tables", "Schema", "TABLE_SCHEMA", 2);
+		dataTable.Rows.Add("Tables", "Table", "TABLE_NAME", 3);
+		dataTable.Rows.Add("Tables", "TableType", "TABLE_TYPE", 4);
 
 		return Utility.CompletedTask;
 	}
@@ -622,8 +626,8 @@ private async Task FillSchemaPrivilegesAsync(IOBehavior ioBehavior, DataTable da
 
 	private async Task FillTablesAsync(IOBehavior ioBehavior, DataTable dataTable, string?[]? restrictionValues, CancellationToken cancellationToken)
 	{
-		if (restrictionValues is not null)
-			throw new ArgumentException("restrictionValues is not supported for schema 'Tables'.", nameof(restrictionValues));
+		if (restrictionValues is { Length: > 4 })
+			throw new ArgumentException("More than 4 restrictionValues are not supported for schema 'Tables'.", nameof(restrictionValues));
 
 		dataTable.Columns.AddRange(new DataColumn[]
 		{
@@ -650,7 +654,20 @@ private async Task FillTablesAsync(IOBehavior ioBehavior, DataTable dataTable, s
 			new("TABLE_COMMENT", typeof(string)),
 		});
 
-		await FillDataTableAsync(ioBehavior, dataTable, "TABLES", null, cancellationToken).ConfigureAwait(false);
+		var columns = new List<KeyValuePair<string, string>>();
+		if (restrictionValues is not null)
+		{
+			if (restrictionValues.Length > 0 && !string.IsNullOrEmpty(restrictionValues[0]))
+				columns.Add(new("TABLE_CATALOG", restrictionValues[0]!));
+			if (restrictionValues.Length > 1 && !string.IsNullOrEmpty(restrictionValues[1]))
+				columns.Add(new("TABLE_SCHEMA", restrictionValues[1]!));
+			if (restrictionValues.Length > 2 && !string.IsNullOrEmpty(restrictionValues[2]))
+				columns.Add(new("TABLE_NAME", restrictionValues[2]!));
+			if (restrictionValues.Length > 3 && !string.IsNullOrEmpty(restrictionValues[3]))
+				columns.Add(new("TABLE_TYPE", restrictionValues[3]!));
+		}
+
+		await FillDataTableAsync(ioBehavior, dataTable, "TABLES", columns, cancellationToken).ConfigureAwait(false);
 	}
 
 	private async Task FillTableConstraintsAsync(IOBehavior ioBehavior, DataTable dataTable, string?[]? restrictionValues, CancellationToken cancellationToken)

tools/SchemaCollectionGenerator/SchemaCollections.yaml

@@ -565,6 +565,16 @@
 - name: Tables
   table: TABLES
   identifierPartCount: 3
+  description: information about tables
+  restrictions:
+  - name: Catalog
+    default: TABLE_CATALOG
+  - name: Schema
+    default: TABLE_SCHEMA
+  - name: Table
+    default: TABLE_NAME
+  - name: TableType
+    default: TABLE_TYPE
   columns:
   - name: TABLE_CATALOG
     type: string