Restructuring "Query database", changing the example of

Author: Oxyjun

src/content/docs/d1/best-practices/query-d1.mdx

@@ -5,51 +5,15 @@ sidebar:
   order: 1
 ---
 
+D1 is compatible with most SQLite's SQL convention since it leverages SQLite's query engine. You can use SQL commands to query D1.
+
 There are a number of ways you can interact with a D1 database:
 
 1. Using [D1 Workers Binding API](/d1/worker-api/) in your code.
-2. Using [SQL API](/d1/sql-api/sql-statements/).
-3. Using [D1 REST API](/api/operations/cloudflare-d1-create-database).
-4. Using [D1 Wrangler commands](/d1/wrangler-commands/).
-
-:::note
-D1 is compatible with most SQLite's SQL convention since it leverages SQLite's query engine.
-:::
-
-## Query D1 with Workers Binding API
-
-Workers Binding API primarily interacts with the data plane, and allows you to query your D1 database from your Worker.
-
-This requires you to:
-
-1. Bind your D1 database to your Worker.
-2. Prepare a statement.
-3. Run the statement.
-
-```js title="index.js"
-export default {
-    async fetch(request, env) {
-        const {pathname} = new URL(request.url);
-        const companyName1 = `Bs Beverages`;
-        const companyName2 = `Around the Horn`;
-        const stmt = env.DB.prepare(`SELECT * FROM Customers WHERE CompanyName = ?`);
-
-        if (pathname === `/RUN`) {
-            const returnValue = await stmt.bind(companyName1).run();
-            return Response.json(returnValue);
-        }
-
-        return new Response(
-            `Welcome to the D1 API Playground!
-						\nChange the URL to test the various methods inside your index.js file.`,
-        );
-    },
-};
-```
-
-Refer to [Workers Binding API](/d1/worker-api/) for more information.
+2. Using [D1 REST API](/api/operations/cloudflare-d1-create-database).
+3. Using [D1 Wrangler commands](/d1/wrangler-commands/).
 
-## Query D1 with SQL API
+## Use SQL to query D1
 
 D1 understands SQLite semantics, which allows you to query a database using SQL statements via Workers BindingAPI or REST API (including Wrangler commands). Refer to [D1 SQL API](/d1/sql-api/sql-statements/) to learn more about supported SQL statements.
 
@@ -101,6 +65,39 @@ SELECT json_extract(sensor_reading, '$.measurement.temp_f')-- returns "77.4" as
 
 Refer to [Query JSON](/d1/sql-api/query-json/) to learn more about querying JSON objects.
 
+## Query D1 with Workers Binding API
+
+Workers Binding API primarily interacts with the data plane, and allows you to query your D1 database from your Worker.
+
+This requires you to:
+
+1. Bind your D1 database to your Worker.
+2. Prepare a statement.
+3. Run the statement.
+
+```js title="index.js"
+export default {
+    async fetch(request, env) {
+        const {pathname} = new URL(request.url);
+        const companyName1 = `Bs Beverages`;
+        const companyName2 = `Around the Horn`;
+        const stmt = env.DB.prepare(`SELECT * FROM Customers WHERE CompanyName = ?`);
+
+        if (pathname === `/RUN`) {
+            const returnValue = await stmt.bind(companyName1).run();
+            return Response.json(returnValue);
+        }
+
+        return new Response(
+            `Welcome to the D1 API Playground!
+						\nChange the URL to test the various methods inside your index.js file.`,
+        );
+    },
+};
+```
+
+Refer to [Workers Binding API](/d1/worker-api/) for more information.
+
 ## Query D1 with REST API
 
 REST API primarily interacts with the control plane, and allows you to create/manage your D1 database.
@@ -112,15 +109,20 @@ Refer to [D1 REST API](/api/operations/cloudflare-d1-create-database) for D1 RES
 You can use Wrangler commands to interact with the control plane. Note that Wrangler commands use REST APIs to perform its operations.
 
 ```sh
-npx wrangler d1 create prod-d1-tutorial
+npx wrangler d1 execute prod-d1-tutorial --command="SELECT * FROM Customers"
 ```
-
 ```sh output
-
-✅ Successfully created DB 'prod-d1-tutorial'
-
-[[d1_databases]]
-binding = "DB" # available in your Worker on env.DB
-database_name = "prod-d1-tutorial"
-database_id = "<unique-ID-for-your-database>"
+🌀 Mapping SQL input into an array of statements
+🌀 Executing on local database production-db-backend (<DATABASE_ID>) from .wrangler/state/v3/d1:
+┌────────────┬─────────────────────┬───────────────────┐
+│ CustomerId │ CompanyName         │ ContactName       │
+├────────────┼─────────────────────┼───────────────────┤
+│ 1          │ Alfreds Futterkiste │ Maria Anders      │
+├────────────┼─────────────────────┼───────────────────┤
+│ 4          │ Around the Horn     │ Thomas Hardy      │
+├────────────┼─────────────────────┼───────────────────┤
+│ 11         │ Bs Beverages        │ Victoria Ashworth │
+├────────────┼─────────────────────┼───────────────────┤
+│ 13         │ Bs Beverages        │ Random Name       │
+└────────────┴─────────────────────┴───────────────────┘
 ```