Updated r2 data catalog duckdb docs to address duckdb iceberg write support and httpfs extension (#25544)

Author: jonesphillip

src/content/docs/r2/data-catalog/config-examples/duckdb.mdx

@@ -3,15 +3,15 @@ title: DuckDB
 pcx_content_type: example
 ---
 
-Below is an example of using [DuckDB](https://duckdb.org/) to connect to R2 Data Catalog (read-only). For more information on connecting to R2 Data Catalog with DuckDB, refer to [DuckDB documentation](https://duckdb.org/docs/stable/core_extensions/iceberg/iceberg_rest_catalogs#r2-catalog).
+Below is an example of using [DuckDB](https://duckdb.org/) to connect to R2 Data Catalog. For more information on connecting to R2 Data Catalog with DuckDB, refer to [DuckDB documentation](https://duckdb.org/docs/stable/core_extensions/iceberg/iceberg_rest_catalogs#r2-catalog).
 
 ## Prerequisites
 
 - Sign up for a [Cloudflare account](https://dash.cloudflare.com/sign-up/workers-and-pages).
 - [Create an R2 bucket](/r2/buckets/create-buckets/) and [enable the data catalog](/r2/data-catalog/manage-catalogs/#enable-r2-data-catalog-on-a-bucket).
 - [Create an R2 API token](/r2/api/tokens/) with both [R2 and data catalog permissions](/r2/api/tokens/#permissions).
 - Install [DuckDB](https://duckdb.org/docs/installation/).
-  - Note: [DuckDB 1.3.0](https://github.com/duckdb/duckdb/releases/tag/v1.3.0) or greater is required to attach [Iceberg REST Catalogs](https://duckdb.org/docs/stable/core_extensions/iceberg/iceberg_rest_catalogs).
+  - Note: [DuckDB 1.4.0](https://github.com/duckdb/duckdb/releases/tag/v1.4.0) or greater is required to attach and write to [Iceberg REST Catalogs](https://duckdb.org/docs/stable/core_extensions/iceberg/iceberg_rest_catalogs).
 
 ## Example usage
 
@@ -22,21 +22,32 @@ In the [DuckDB CLI](https://duckdb.org/docs/stable/clients/cli/overview.html) (C
 INSTALL iceberg;
 LOAD iceberg;
 
+-- Install and load httpfs extension for reading/writing files over HTTP(S).
+INSTALL httpfs;
+LOAD httpfs;
+
 -- Create a DuckDB secret to store R2 Data Catalog credentials.
 CREATE SECRET r2_secret (
     TYPE ICEBERG,
     TOKEN '<token>'
 );
 
--- Attach R2 Data Catalog with the following ATTACH statement (read-only).
+-- Attach R2 Data Catalog with the following ATTACH statement.
 ATTACH '<warehouse_name>' AS my_r2_catalog (
     TYPE ICEBERG,
     ENDPOINT '<catalog_uri>'
 );
 
+-- Create the default schema in the catalog and set it as the active schema.
+CREATE SCHEMA my_r2_catalog.default;
+USE my_r2_catalog.default;
+
+-- Create and populate a sample Iceberg table with data.
+CREATE TABLE my_iceberg_table AS SELECT a FROM range(4) t(a);
+
 -- Show all available tables.
 SHOW ALL TABLES;
 
--- Query your Iceberg table.
+-- Query the Iceberg table you just created.
 SELECT * FROM my_r2_catalog.default.my_iceberg_table;
 ```