Moving Wrangler commands out of Reference. Reshuffling chapters.

Oxyjun · Oxyjun · commit 194a9531a43d · 2024-11-22T17:15:28.000Z
diff --git a/src/content/docs/d1/build-with-d1/d1-client-api.mdx b/src/content/docs/d1/build-with-d1/d1-client-api.mdx
diff --git a/src/content/docs/d1/build-with-d1/query-d1.mdx b/src/content/docs/d1/build-with-d1/query-d1.mdx
@@ -0,0 +1,18 @@
+---
+title: Query D1
+pcx_content_type: concept
+sidebar:
+  order: 1
+---
+
+There are three primary ways you can query a D1 database:
+
+1. Using [D1 Workers Binding API](/d1/worker-api/) in your code.
+2. Using [D1 REST API](/api/operations/cloudflare-d1-create-database).
+3. Using [D1 Wrangler commands](/d1/wrangler-commands/).
+
+## Query D1 with Workers Binding API
+
+## Query D1 with REST API
+
+## Query D1 with Wrangler commands
diff --git a/src/content/docs/d1/configuration/index.mdx b/src/content/docs/d1/configuration/index.mdx
@@ -2,7 +2,7 @@
 title: Configuration
 pcx_content_type: navigation
 sidebar:
-  order: 6
+  order: 8
   group:
     hideIndex: true
 ---
diff --git a/src/content/docs/d1/demos.mdx b/src/content/docs/d1/demos.mdx
@@ -2,7 +2,7 @@
 pcx_content_type: navigation
 title: Demos and architectures
 sidebar:
-  order: 10
+  order: 12
 
 ---
 
diff --git a/src/content/docs/d1/examples/index.mdx b/src/content/docs/d1/examples/index.mdx
@@ -4,7 +4,7 @@ hideChildren: false
 pcx_content_type: navigation
 title: Examples
 sidebar:
-  order: 8
+  order: 10
   group:
     hideIndex: true
 ---
diff --git a/src/content/docs/d1/observability/index.mdx b/src/content/docs/d1/observability/index.mdx
@@ -2,7 +2,7 @@
 title: Observability
 pcx_content_type: navigation
 sidebar:
-  order: 7
+  order: 9
   group:
     hideIndex: true
 ---
diff --git a/src/content/docs/d1/platform/index.mdx b/src/content/docs/d1/platform/index.mdx
@@ -2,7 +2,7 @@
 pcx_content_type: navigation
 title: Platform
 sidebar:
-  order: 10
+  order: 12
   group:
     hideIndex: true
 ---
diff --git a/src/content/docs/d1/reference/index.mdx b/src/content/docs/d1/reference/index.mdx
@@ -2,7 +2,7 @@
 pcx_content_type: navigation
 title: Reference
 sidebar:
-  order: 11
+  order: 13
   group:
     hideIndex: true
 ---
diff --git a/src/content/docs/d1/reference/wrangler-commands.mdx b/src/content/docs/d1/reference/wrangler-commands.mdx
diff --git a/src/content/docs/d1/rest-api/d1-api.mdx b/src/content/docs/d1/rest-api/d1-api.mdx
diff --git a/src/content/docs/d1/rest-api/index.mdx b/src/content/docs/d1/rest-api/index.mdx
@@ -0,0 +1,12 @@
+---
+pcx_content_type: navigation
+title: REST API
+sidebar:
+  order: 5
+  group:
+    hideIndex: true
+---
+
+import { DirectoryListing } from "~/components";
+
+<DirectoryListing />
diff --git a/src/content/docs/d1/rest-api/wrangler-commands.mdx b/src/content/docs/d1/rest-api/wrangler-commands.mdx
@@ -0,0 +1,11 @@
+---
+pcx_content_type: concept
+title: Wrangler commands
+sidebar:
+  order: 6
+
+---
+
+import { Render, Type, MetaInfo } from "~/components"
+
+<Render file="wrangler-commands/d1" product="workers" />
diff --git a/src/content/docs/d1/sql-api/index.mdx b/src/content/docs/d1/sql-api/index.mdx
@@ -2,7 +2,7 @@
 title: SQL API
 pcx_content_type: navigation
 sidebar:
-  order: 5
+  order: 6
   group:
     hideIndex: true
 ---
diff --git a/src/content/docs/d1/tutorials/index.mdx b/src/content/docs/d1/tutorials/index.mdx
@@ -4,7 +4,7 @@ pcx_content_type: navigation
 title: Tutorials
 hideChildren: true
 sidebar:
-  order: 9
+  order: 11
 
 ---
 
diff --git a/src/content/docs/d1/worker-api/index.mdx b/src/content/docs/d1/worker-api/index.mdx
@@ -38,6 +38,28 @@ const result = await env.MY_DB.prepare(
 ).run<OrderRow>();
 ```
 
+## Type conversion
+
+D1 automatically converts supported JavaScript (including TypeScript) types passed as parameters via the Workers Binding API to their associated D1 types. The type conversion is as follows:
+
+| JavaScript           | D1                                                                           |
+| -------------------- | ---------------------------------------------------------------------------- |
+| null                 | `NULL`                                                                       |
+| Number               | `REAL`                                                                       |
+| Number <sup>1</sup>  | `INTEGER`                                                                    |
+| String               | `TEXT`                                                                       |
+| Boolean <sup>2</sup> | `INTEGER`                                                                    |
+| ArrayBuffer          | `BLOB`                                                                       |
+| undefined            | Not supported. Queries with `undefined` values will return a `D1_TYPE_ERROR` |
+
+<sup>1</sup> D1 supports 64-bit signed `INTEGER` values internally, however
+[BigInts](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/BigInt)
+are not currently supported in the API yet. JavaScript integers are safe up to
+[`Number.MAX_SAFE_INTEGER`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number/MAX_SAFE_INTEGER).
+
+<sup>2</sup> Booleans will be cast to an `INTEGER` type where `1` is `TRUE` and
+`0` is `FALSE`.
+
 ## API playground
 
 The D1 Worker Binding API playground is an `index.js` file where you can test each of the documented Worker Binding APIs for D1. The file builds from the end-state of the [Get started](/d1/get-started/#write-queries-within-your-worker) code.
diff --git a/src/content/docs/workers/wrangler/commands.mdx b/src/content/docs/workers/wrangler/commands.mdx
diff --git a/src/content/partials/workers/wrangler-commands/d1.mdx b/src/content/partials/workers/wrangler-commands/d1.mdx
