Skip to content
This repository was archived by the owner on Jun 2, 2025. It is now read-only.

Commit abdd93e

Browse files
JanJakesJanJakes
committed
Add comments explaining <prefix> placeholder
1 parent b48f210 commit abdd93e

File tree

1 file changed

+33
-33
lines changed

1 file changed

+33
-33
lines changed

‎wp-includes/sqlite-ast/class-wp-sqlite-information-schema-builder.php

Lines changed: 33 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ class WP_SQLite_Information_Schema_Builder {
2929
*/
3030
const CREATE_INFORMATION_SCHEMA_QUERIES = array(
3131
// TABLES
32-
"CREATE TABLE IF NOT EXISTS <prefix>tables (
32+
"CREATE TABLE IF NOT EXISTS <prefix>tables ( -- '<prefix>' is a placeholder replaced at runtime
3333
TABLE_CATALOG TEXT NOT NULL DEFAULT 'def', -- always 'def'
3434
TABLE_SCHEMA TEXT NOT NULL, -- database name
3535
TABLE_NAME TEXT NOT NULL, -- table name
@@ -55,7 +55,7 @@ class WP_SQLite_Information_Schema_Builder {
5555
) STRICT",
5656

5757
// COLUMNS
58-
"CREATE TABLE IF NOT EXISTS <prefix>columns (
58+
"CREATE TABLE IF NOT EXISTS <prefix>columns ( -- '<prefix>' is a placeholder replaced at runtime
5959
TABLE_CATALOG TEXT NOT NULL DEFAULT 'def', -- always 'def'
6060
TABLE_SCHEMA TEXT NOT NULL, -- database name
6161
TABLE_NAME TEXT NOT NULL, -- table name
@@ -82,7 +82,7 @@ class WP_SQLite_Information_Schema_Builder {
8282

8383
// VIEWS
8484
// @TODO: Implement.
85-
'CREATE TABLE IF NOT EXISTS <prefix>views (
85+
"CREATE TABLE IF NOT EXISTS <prefix>views ( -- '<prefix>' is a placeholder replaced at runtime
8686
TABLE_CATALOG TEXT NOT NULL,
8787
TABLE_SCHEMA TEXT NOT NULL,
8888
TABLE_NAME TEXT NOT NULL,
@@ -94,54 +94,54 @@ class WP_SQLite_Information_Schema_Builder {
9494
CHARACTER_SET_CLIENT TEXT NOT NULL,
9595
COLLATION_CONNECTION TEXT NOT NULL,
9696
ALGORITHM TEXT NOT NULL
97-
) STRICT',
97+
) STRICT",
9898

9999
// STATISTICS (indexes)
100-
"CREATE TABLE IF NOT EXISTS <prefix>statistics (
101-
TABLE_CATALOG TEXT NOT NULL DEFAULT 'def', -- always 'def'
102-
TABLE_SCHEMA TEXT NOT NULL, -- database name
103-
TABLE_NAME TEXT NOT NULL, -- table name
104-
NON_UNIQUE INTEGER NOT NULL, -- 0 for unique indexes, 1 otherwise
105-
INDEX_SCHEMA TEXT NOT NULL, -- index database name
106-
INDEX_NAME TEXT NOT NULL, -- index name, for PKs always 'PRIMARY'
107-
SEQ_IN_INDEX INTEGER NOT NULL, -- column position in index (from 1)
108-
COLUMN_NAME TEXT, -- column name (NULL for functional indexes)
109-
COLLATION TEXT, -- column sort in the index ('A', 'D', or NULL)
110-
CARDINALITY INTEGER, -- not implemented
111-
SUB_PART INTEGER, -- number of indexed chars, NULL for full column
112-
PACKED TEXT, -- not implemented
113-
NULLABLE TEXT NOT NULL, -- 'YES' if column can contain NULL, '' otherwise
114-
INDEX_TYPE TEXT NOT NULL, -- 'BTREE', 'FULLTEXT', 'SPATIAL'
115-
COMMENT TEXT NOT NULL DEFAULT '', -- not implemented
116-
INDEX_COMMENT TEXT NOT NULL DEFAULT '', -- index comment
117-
IS_VISIBLE TEXT NOT NULL DEFAULT 'YES', -- 'NO' if column is hidden, 'YES' otherwise
118-
EXPRESSION TEXT -- expression for functional indexes
100+
"CREATE TABLE IF NOT EXISTS <prefix>statistics ( -- '<prefix>' is a placeholder replaced at runtime
101+
TABLE_CATALOG TEXT NOT NULL DEFAULT 'def', -- always 'def'
102+
TABLE_SCHEMA TEXT NOT NULL, -- database name
103+
TABLE_NAME TEXT NOT NULL, -- table name
104+
NON_UNIQUE INTEGER NOT NULL, -- 0 for unique indexes, 1 otherwise
105+
INDEX_SCHEMA TEXT NOT NULL, -- index database name
106+
INDEX_NAME TEXT NOT NULL, -- index name, for PKs always 'PRIMARY'
107+
SEQ_IN_INDEX INTEGER NOT NULL, -- column position in index (from 1)
108+
COLUMN_NAME TEXT, -- column name (NULL for functional indexes)
109+
COLLATION TEXT, -- column sort in the index ('A', 'D', or NULL)
110+
CARDINALITY INTEGER, -- not implemented
111+
SUB_PART INTEGER, -- number of indexed chars, NULL for full column
112+
PACKED TEXT, -- not implemented
113+
NULLABLE TEXT NOT NULL, -- 'YES' if column can contain NULL, '' otherwise
114+
INDEX_TYPE TEXT NOT NULL, -- 'BTREE', 'FULLTEXT', 'SPATIAL'
115+
COMMENT TEXT NOT NULL DEFAULT '', -- not implemented
116+
INDEX_COMMENT TEXT NOT NULL DEFAULT '', -- index comment
117+
IS_VISIBLE TEXT NOT NULL DEFAULT 'YES', -- 'NO' if column is hidden, 'YES' otherwise
118+
EXPRESSION TEXT -- expression for functional indexes
119119
) STRICT",
120120

121121
// TABLE_CONSTRAINTS
122122
// @TODO: Implement. Could this be just a view?
123-
'CREATE TABLE IF NOT EXISTS <prefix>constraints (
123+
"CREATE TABLE IF NOT EXISTS <prefix>constraints ( -- '<prefix>' is a placeholder replaced at runtime
124124
CONSTRAINT_CATALOG TEXT NOT NULL,
125125
CONSTRAINT_SCHEMA TEXT NOT NULL,
126126
CONSTRAINT_NAME TEXT NOT NULL,
127127
TABLE_SCHEMA TEXT NOT NULL,
128128
TABLE_NAME TEXT NOT NULL,
129129
CONSTRAINT_TYPE TEXT NOT NULL
130-
) STRICT',
130+
) STRICT",
131131

132132
// CHECK_CONSTRAINTS
133133
// @TODO: Implement.
134-
'CREATE TABLE IF NOT EXISTS <prefix>check_constraints (
134+
"CREATE TABLE IF NOT EXISTS <prefix>check_constraints ( -- '<prefix>' is a placeholder replaced at runtime
135135
CONSTRAINT_CATALOG TEXT NOT NULL,
136136
CONSTRAINT_SCHEMA TEXT NOT NULL,
137137
TABLE_NAME TEXT NOT NULL,
138138
CONSTRAINT_NAME TEXT NOT NULL,
139139
CHECK_CLAUSE TEXT NOT NULL
140-
) STRICT',
140+
) STRICT",
141141

142142
// KEY_COLUMN_USAGE
143143
// @TODO: Implement.
144-
'CREATE TABLE IF NOT EXISTS <prefix>key_column_usage (
144+
"CREATE TABLE IF NOT EXISTS <prefix>key_column_usage ( -- '<prefix>' is a placeholder replaced at runtime
145145
CONSTRAINT_CATALOG TEXT NOT NULL,
146146
CONSTRAINT_SCHEMA TEXT NOT NULL,
147147
CONSTRAINT_NAME TEXT NOT NULL,
@@ -154,11 +154,11 @@ class WP_SQLite_Information_Schema_Builder {
154154
REFERENCED_TABLE_SCHEMA TEXT,
155155
REFERENCED_TABLE_NAME TEXT,
156156
REFERENCED_COLUMN_NAME TEXT
157-
) STRICT',
157+
) STRICT",
158158

159159
// REFERENTIAL_CONSTRAINTS
160160
// @TODO: Implement.
161-
'CREATE TABLE IF NOT EXISTS <prefix>referential_constraints (
161+
"CREATE TABLE IF NOT EXISTS <prefix>referential_constraints ( -- '<prefix>' is a placeholder replaced at runtime
162162
CONSTRAINT_CATALOG TEXT NOT NULL,
163163
CONSTRAINT_SCHEMA TEXT NOT NULL,
164164
CONSTRAINT_NAME TEXT NOT NULL,
@@ -169,11 +169,11 @@ class WP_SQLite_Information_Schema_Builder {
169169
UPDATE_RULE TEXT NOT NULL,
170170
DELETE_RULE TEXT NOT NULL,
171171
REFERENCED_TABLE_NAME TEXT NOT NULL
172-
) STRICT',
172+
) STRICT",
173173

174174
// TRIGGERS
175175
// @TODO: Implement.
176-
'CREATE TABLE IF NOT EXISTS <prefix>triggers (
176+
"CREATE TABLE IF NOT EXISTS <prefix>triggers ( -- '<prefix>' is a placeholder replaced at runtime
177177
TRIGGER_CATALOG TEXT NOT NULL,
178178
TRIGGER_SCHEMA TEXT NOT NULL,
179179
TRIGGER_NAME TEXT NOT NULL,
@@ -196,7 +196,7 @@ class WP_SQLite_Information_Schema_Builder {
196196
CHARACTER_SET_CLIENT TEXT NOT NULL,
197197
COLLATION_CONNECTION TEXT NOT NULL,
198198
DATABASE_COLLATION TEXT NOT NULL
199-
) STRICT',
199+
) STRICT",
200200
);
201201

202202
/**

0 commit comments

Comments
 (0)