@@ -13,12 +13,12 @@ Choosing the best insert method is an easy way to improve insert performance.
1313
1414The three types of insert statements are:
1515
16- - {ref}` Single inserts <inserts_single_inserts > `
17- - {ref}` UNNEST <inserts_unnest > `
18- - {ref}` Multiple value expressions <inserts_multiple_values > `
16+ - {ref}` Single inserts <inserts-single-inserts > `
17+ - {ref}` UNNEST <inserts-unnest > `
18+ - {ref}` Multiple value expressions <inserts-multiple-values > `
1919
2020Each type of statement can be issued using any of the three types of
21- {ref}` client approaches <inserts_client_approaches > ` , which we cover in
21+ {ref}` client approaches <inserts-client-approaches > ` , which we cover in
2222the next section.
2323
2424(inserts-single-inserts)=
@@ -150,23 +150,23 @@ method.
150150
151151The three client approaches for doing inserts are:
152152
153- - {ref}` Standard querying <inserts_standard_querying > `
154- - {ref}` Bulk operations <inserts_bulk_operations > `
155- - {ref}` Prepared statements <inserts_prepared_statements > `
153+ - {ref}` Standard querying <inserts-standard-querying > `
154+ - {ref}` Bulk operations <inserts-bulk-operations > `
155+ - {ref}` Prepared statements <inserts-prepared-statements > `
156156
157157Each client approach can be used to insert {ref}`any type of insert statement
158- <insert_statement_types >`.
158+ <insert-statement-types >`.
159159
160160(inserts-standard-querying)=
161161
162162### Standard querying
163163
164164The standard way of issuing insert statements executes one statement at a time
165- and does not make use of {ref}` inserts_bulk_operations ` or any special
166- {ref}` inserts_prepared_statements ` client feature.
165+ and does not make use of {ref}` inserts-bulk-operations ` or any special
166+ {ref}` inserts-prepared-statements ` client feature.
167167
168168For example, using the CrateDB Python client, here's a {ref}`single insert
169- <inserts_single_inserts >`:
169+ <inserts-single-inserts >`:
170170
171171``` python
172172client.execute(" INSERT INTO my_table (column_a) VALUES (?)" , [" value 1" ])
@@ -180,7 +180,7 @@ You can use the {ref}`bulk operations <crate-reference:http-bulk-ops>` feature
180180of the {ref}` CrateDB HTTP endpoint <crate-reference:interface-http> ` to perform
181181many inserts in a single operation.
182182
183- The advantages are the same as using the {ref}` UNNEST method <inserts_unnest > ` :
183+ The advantages are the same as using the {ref}` UNNEST method <inserts-unnest > ` :
184184
185185- Significantly less internal network traffic than executing each insert
186186 statement individually
@@ -192,10 +192,10 @@ The advantages are the same as using the {ref}`UNNEST method <inserts_unnest>`:
192192Because the advantages are the same as using the ` UNNEST ` method, you
193193typically will not see a performance improvement by combining bulk operations
194194with ` UNNEST ` statements or statements with {ref}`multiple value expressions
195- <inserts_multiple_values >`.
195+ <inserts-multiple-values >`.
196196
197197Bulk operations are typically done with {ref}`single insert statements
198- <inserts_single_inserts >` as an alternative to the ` UNNEST` method.
198+ <inserts-single-inserts >` as an alternative to the ` UNNEST` method.
199199
200200:::{SEEALSO}
201201{ref}` Performance: Bulk inserts <bulk-inserts> `
@@ -235,20 +235,20 @@ use the binary protocol, contain almost no headers, and are executed over an
235235already established connection.
236236
237237Typically, prepared statements are used {ref}`single insert statements
238- <inserts_single_inserts >`.
238+ <inserts-single-inserts >`.
239239
240240Prepared statements with single inserts will usually perform better than
241- {ref}` standard querying <inserts_standard_querying > ` with single inserts, and
241+ {ref}` standard querying <inserts-standard-querying > ` with single inserts, and
242242should be comparable to standard querying with both the {ref}`UNNEST
243- method <inserts_unnest >` and {ref} ` multiple value expressions
244- <inserts_multiple_values >`.
243+ method <inserts-unnest >` and {ref} ` multiple value expressions
244+ <inserts-multiple-values >`.
245245
246246## Testing
247247
248248Follow the basic {ref}`inserts performance testing
249- <testing_inserts_performance >` procedure.
249+ <testing-inserts-performance >` procedure.
250250
251- To test {ref}` bulk operations <inserts_bulk_operations > ` , you should:
251+ To test {ref}` bulk operations <inserts-bulk-operations > ` , you should:
252252
2532531 . Configure the setup you would like to test
2542542 . Run a number of different tests against that setup, using different
0 commit comments