Add example with minio client

README.md

@@ -8,12 +8,40 @@ Fishbase and Sealifebase data can now be accessed programmatically using a stand
 https://fishbase.ropensci.org/fishbase
 https://fishbase.ropensci.org/sealifebase
 
+These endpoints are provided by the open source [MINIO Server](https://min.io/) which conforms to the current (v4) [AWS S3 REST API](https://docs.aws.amazon.com/AmazonS3/latest/API/Welcome.html).  This supports direct REST queries or any of the many great and well-maintained client packages and tools, including [minio client](https://min.io/docs/minio/linux/reference/minio-mc.html),  [python `boto`](https://aws.amazon.com/sdk-for-python/), [Apache Arrow](https://arrow.apache.org/), etc.   
+
+## Python Example
+
 For example, in python:
 
 ```python
 import duckdb
 duckdb.read_parquet("https://fishbase.ropensci.org/fishbase/species.parquet") 
 ```
 
-These endpoints are provided by the open source [MINIO Server](https://min.io/) which conforms to the current (v4) [AWS S3 REST API](https://docs.aws.amazon.com/AmazonS3/latest/API/Welcome.html).  This supports direct REST queries or any of the many great and well-maintained client packages and tools, including [minio client](https://min.io/docs/minio/linux/reference/minio-mc.html),  [python `boto`](https://aws.amazon.com/sdk-for-python/), [Apache Arrow](https://arrow.apache.org/), etc.   
+## CLI Example
 
+With the minio CLI, one can explore the bucket like
+```bash
+$ mc alias set fishbase https://fishbase.ropensci.org
+$ mc ls fishbase/sealifebase
+[2024-08-01 19:31:44 BST]  23KiB STANDARD abnorm.parquet
+[2024-08-01 19:31:44 BST] 311KiB STANDARD abundance.parquet
+[2024-08-01 19:31:44 BST]  13KiB STANDARD abundance_delta.parquet
+```
+
+Then, use the DuckDB CLI to view the schema for a given parquet file
+
+```
+$ mc get 'fishbase/sealifebase/comnames_all.parquet' comnames_all.parquet
+.../sealifebase/comnames_all.parquet: 1.39 MiB / 1.39 MiB ┃▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓┃ 434.60 KiB/s 3s
+$ duckdb
+...
+D DESCRIBE SELECT * FROM 'comnames_all.parquet';
+┌─────────────┬─────────────┬─────────┬─────────┬─────────┬─────────┐
+│ column_name │ column_type │  null   │   key   │ default │  extra  │
+│   varchar   │   varchar   │ varchar │ varchar │ varchar │ varchar │
+├─────────────┼─────────────┼─────────┼─────────┼─────────┼─────────┤
+│ SpeciesId   │ INTEGER     │ YES     │ NULL    │ NULL    │ NULL    │
+...
+```