[DDSQL] DDSQL type and type literal docs #31252
Conversation
✅ Documentation Team ReviewThe documentation team has approved this pull request. Thank you for your contribution! |
bradbesserman
force-pushed
the
brad.besserman/ddsql-type-and-type-literal-docs
branch
from
5a29a06 to
8a163ca
Compare
Preview links (active after the
|
bradbesserman
force-pushed
the
brad.besserman/ddsql-type-and-type-literal-docs
branch
from
8a163ca to
359aeb5
Compare
bradbesserman
force-pushed
the
brad.besserman/ddsql-type-and-type-literal-docs
branch
from
359aeb5 to
c91b759
Compare
Co-authored-by: May Lee <may.lee@datadoghq.com>
Co-authored-by: May Lee <may.lee@datadoghq.com>
maycmlee
left a comment
maycmlee
left a comment
There was a problem hiding this comment.
LGTM! Is this ready to merge?
@maycmlee Yes! |
|
|
||
| ### Array types | ||
|
|
||
| All data types except `JSON` support array types. Arrays can contain multiple values of the same data type. |
There was a problem hiding this comment.
select array_agg(x) from (select cast('{"x":1}' as json) x union all select cast('{"x":2}' as json)) seems to work fine?
| | `TIMESTAMP` | `TIMESTAMP 'value'` | `TIMESTAMP '2023-12-25 10:30:00'` | | ||
| | `VARCHAR` | `VARCHAR 'value'` | `VARCHAR 'hello world'` | | ||
|
|
||
| The type prefix can be omitted and the type is automatically inferred from the value. For example, `'hello world'` is inferred as `VARCHAR`, `123` as `BIGINT`, and `true` as `BOOLEAN`. |
There was a problem hiding this comment.
Consider including some guidance on when to use the type prefix. It's not clear why users need this.
| price * DOUBLE 1.08 AS price_with_tax, | ||
| created_at + INTERVAL '7 days' AS expiry_date | ||
| FROM products | ||
| WHERE active = BOOLEAN true; |
There was a problem hiding this comment.
I'm a bit torn about including a where clause like this, which I think idiomatically should be written WHERE active. I understand it's an example for demonstration. But is there an example where you actually benefit from this syntax?
What does this PR do? What is the motivation?
This PR adds docs for DDSQL types and type literals. It is based on a request in this thread.
Preview link -> https://docs-staging.datadoghq.com/brad.besserman/ddsql-type-and-type-literal-docs/ddsql_reference/#data-types
Merge instructions
Merge readiness: