Skip to content

Commit 87c52cf

Browse files
better docs
1 parent a65c120 commit 87c52cf

File tree

2 files changed

+7
-2
lines changed

2 files changed

+7
-2
lines changed

docs/api/quick-start/index.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,8 @@ description: Get started with our API fast using these quick start guides.
55

66
If you're looking for example queries to use (such as NFT or ERC20 balances or holders), then [check out these endpoints](../quick-start/api-ready-queries.md).
77

8+
If you're setting up an ingestion pipeline, check out this one [using Python and Celery](https://adamparrish.xyz/downstream-data-extract-transform-load).
9+
810
Get started with our API fast using these quick start guides:
911

1012
<div class="cards grid" markdown>

docs/reference/dune-v2/query-engine.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,8 @@ With Dune V2 we’re moving away from a [PostgreSQL](https://www.postgresql.org/
1515
The syntax and keyword operator differences between Postgres, Spark, and Dune SQL are quite minimal, however there are a few to be aware of.
1616

1717
!!! warning
18-
**Dune SQL is still in alpha!** If you find any other changes in Spark or Dune SQL that are important to note, please feel free to [submit a PR to this docs page on GitHub](https://github.com/duneanalytics/docs/edit/master/docs/reference/dune-v2/query-engine.md) or let us know in #dune-sql.
18+
**Dune SQL is still in alpha!** If you find any other changes in Spark or Dune SQL that are important to note, please feel free to [submit a PR to this docs page on GitHub](https://github.com/duneanalytics/docs/edit/master/docs/reference/dune-v2/query-engine.md) or let us know in #dune-sql.
19+
**If you're running into errors using `||`, `concat()`, `replace()`, `trim()`, `length()`, or other operators on bytearrays (things like addresses, transactions, etc)** then check out the [Byte Array Functions](#byte-array-functions-in-dune-SQL) section.
1920

2021
### Syntax Comparison
2122

@@ -71,7 +72,9 @@ The byte array conversion functions throw an overflow exception if the byte arra
7172

7273
## Byte Array Functions in Dune SQL
7374

74-
Dune SQL currently represents byte arrays as `0x`-prefixed strings. In the future we will represent byte arrays using the `varbinary`. To make it simpler to work with byte arrays we have the following helper functions. They simplify interactions with byte arrays, as they automatically account for the `0x`-prefix and use byte index instead of characther index. For instance, the `bytearray_substring` methods take indexes by byte, not by characther (twice the byte array length). If there is an operation you need to do on byte arrays which is not covered by a function in the list below you should reach out to the Dune team.
75+
Dune SQL currently represents byte arrays as `0x`-prefixed strings. In the future we will represent byte arrays using the `varbinary`. To make it simpler to work with byte arrays we have the following helper functions. They simplify interactions with byte arrays, as they automatically account for the `0x`-prefix and use byte index instead of characther index. For instance, the `bytearray_substring` methods take indexes by byte, not by characther (twice the byte array length). If there is an operation you need to do on byte arrays which is not covered by a function in the list below you should reach out to the Dune team.
76+
77+
*Operators like `||` and functions like `concat()` will no longer work with bytearrays, you will need to `cast(some_bytearray as varchar)` first.*
7578

7679
| Function | Return Type | Argument Types | Description |
7780
| --- | --- | --- | --- |

0 commit comments

Comments
 (0)