Skip to content

Commit db83140

Browse files
ClaudeClaude
authored andcommitted
fix: Add nanosecond timestamp range limitation to MSSQL and Oracle versioned docs
Commit d5341c4 documented the Arrow nanosecond timestamp range limitation (~1677–2262) for MSSQL and Oracle connectors, but only in website/docs/ (vNext). The limitation existed in all prior versions too — in versions 1.5.x–1.11.x, out-of-range timestamps silently returned 1970-01-01 UTC instead of erroring. Propagate the limitation note to all 7 versioned doc directories (14 files total) with version-appropriate wording.
1 parent ee611de commit db83140

14 files changed

Lines changed: 14 additions & 0 deletions

File tree

website/versioned_docs/version-1.10.x/components/data-connectors/mssql.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,7 @@ The Microsoft SQL Server Data Connector enables federated/accelerated SQL querie
1212

1313
1. The connector supports SQL Server authentication (SQL Login and Password) only.
1414
1. Spatial types (`geography`) are not supported, and columns with these types will be ignored.
15+
1. `DATETIME2` and `DATETIMEOFFSET` columns are mapped to Arrow `Timestamp(Nanosecond)`. Timestamps outside the nanosecond range (approximately years 1677–2262) will silently return `1970-01-01 UTC`. This is an inherent limitation of Arrow's nanosecond timestamp representation.
1516

1617
:::
1718

website/versioned_docs/version-1.10.x/components/data-connectors/oracle.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -117,6 +117,7 @@ The table below shows the Oracle data types supported, along with the type mappi
117117
:::note
118118

119119
- The Oracle `TIMESTAMP WITH LOCAL TIME ZONE` value is retrieved as a UTC time value.
120+
- `TIMESTAMP`, `TIMESTAMP WITH TIME ZONE`, and `TIMESTAMP WITH LOCAL TIME ZONE` columns with non-zero precision are mapped to `Timestamp(Nanosecond)`. Timestamps outside the nanosecond range (approximately years 1677–2262) will silently return `1970-01-01 UTC`. This is an inherent limitation of Arrow's nanosecond timestamp representation.
120121

121122
:::
122123

website/versioned_docs/version-1.11.x/components/data-connectors/mssql.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,7 @@ The Microsoft SQL Server Data Connector enables federated/accelerated SQL querie
1212

1313
1. The connector supports SQL Server authentication (SQL Login and Password) only.
1414
1. Spatial types (`geography`) are not supported, and columns with these types will be ignored.
15+
1. `DATETIME2` and `DATETIMEOFFSET` columns are mapped to Arrow `Timestamp(Nanosecond)`. Timestamps outside the nanosecond range (approximately years 1677–2262) will silently return `1970-01-01 UTC`. This is an inherent limitation of Arrow's nanosecond timestamp representation.
1516

1617
:::
1718

website/versioned_docs/version-1.11.x/components/data-connectors/oracle.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -117,6 +117,7 @@ The table below shows the Oracle data types supported, along with the type mappi
117117
:::note
118118

119119
- The Oracle `TIMESTAMP WITH LOCAL TIME ZONE` value is retrieved as a UTC time value.
120+
- `TIMESTAMP`, `TIMESTAMP WITH TIME ZONE`, and `TIMESTAMP WITH LOCAL TIME ZONE` columns with non-zero precision are mapped to `Timestamp(Nanosecond)`. Timestamps outside the nanosecond range (approximately years 1677–2262) will silently return `1970-01-01 UTC`. This is an inherent limitation of Arrow's nanosecond timestamp representation.
120121

121122
:::
122123

website/versioned_docs/version-1.5.x/components/data-connectors/mssql.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,7 @@ The Microsoft SQL Server Data Connector enables federated/accelerated SQL querie
1212

1313
1. The connector supports SQL Server authentication (SQL Login and Password) only.
1414
1. Spatial types (`geography`) are not supported, and columns with these types will be ignored.
15+
1. `DATETIME2` and `DATETIMEOFFSET` columns are mapped to Arrow `Timestamp(Nanosecond)`. Timestamps outside the nanosecond range (approximately years 1677–2262) will silently return `1970-01-01 UTC`. This is an inherent limitation of Arrow's nanosecond timestamp representation.
1516

1617
:::
1718

website/versioned_docs/version-1.5.x/components/data-connectors/oracle.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -117,6 +117,7 @@ The table below shows the Oracle data types supported, along with the type mappi
117117
:::note
118118

119119
- The Oracle `TIMESTAMP WITH LOCAL TIME ZONE` value is retrieved as a UTC time value.
120+
- `TIMESTAMP`, `TIMESTAMP WITH TIME ZONE`, and `TIMESTAMP WITH LOCAL TIME ZONE` columns with non-zero precision are mapped to `Timestamp(Nanosecond)`. Timestamps outside the nanosecond range (approximately years 1677–2262) will silently return `1970-01-01 UTC`. This is an inherent limitation of Arrow's nanosecond timestamp representation.
120121

121122
:::
122123

website/versioned_docs/version-1.6.x/components/data-connectors/mssql.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,7 @@ The Microsoft SQL Server Data Connector enables federated/accelerated SQL querie
1212

1313
1. The connector supports SQL Server authentication (SQL Login and Password) only.
1414
1. Spatial types (`geography`) are not supported, and columns with these types will be ignored.
15+
1. `DATETIME2` and `DATETIMEOFFSET` columns are mapped to Arrow `Timestamp(Nanosecond)`. Timestamps outside the nanosecond range (approximately years 1677–2262) will silently return `1970-01-01 UTC`. This is an inherent limitation of Arrow's nanosecond timestamp representation.
1516

1617
:::
1718

website/versioned_docs/version-1.6.x/components/data-connectors/oracle.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -117,6 +117,7 @@ The table below shows the Oracle data types supported, along with the type mappi
117117
:::note
118118

119119
- The Oracle `TIMESTAMP WITH LOCAL TIME ZONE` value is retrieved as a UTC time value.
120+
- `TIMESTAMP`, `TIMESTAMP WITH TIME ZONE`, and `TIMESTAMP WITH LOCAL TIME ZONE` columns with non-zero precision are mapped to `Timestamp(Nanosecond)`. Timestamps outside the nanosecond range (approximately years 1677–2262) will silently return `1970-01-01 UTC`. This is an inherent limitation of Arrow's nanosecond timestamp representation.
120121

121122
:::
122123

website/versioned_docs/version-1.7.x/components/data-connectors/mssql.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,7 @@ The Microsoft SQL Server Data Connector enables federated/accelerated SQL querie
1212

1313
1. The connector supports SQL Server authentication (SQL Login and Password) only.
1414
1. Spatial types (`geography`) are not supported, and columns with these types will be ignored.
15+
1. `DATETIME2` and `DATETIMEOFFSET` columns are mapped to Arrow `Timestamp(Nanosecond)`. Timestamps outside the nanosecond range (approximately years 1677–2262) will silently return `1970-01-01 UTC`. This is an inherent limitation of Arrow's nanosecond timestamp representation.
1516

1617
:::
1718

website/versioned_docs/version-1.7.x/components/data-connectors/oracle.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -117,6 +117,7 @@ The table below shows the Oracle data types supported, along with the type mappi
117117
:::note
118118

119119
- The Oracle `TIMESTAMP WITH LOCAL TIME ZONE` value is retrieved as a UTC time value.
120+
- `TIMESTAMP`, `TIMESTAMP WITH TIME ZONE`, and `TIMESTAMP WITH LOCAL TIME ZONE` columns with non-zero precision are mapped to `Timestamp(Nanosecond)`. Timestamps outside the nanosecond range (approximately years 1677–2262) will silently return `1970-01-01 UTC`. This is an inherent limitation of Arrow's nanosecond timestamp representation.
120121

121122
:::
122123

0 commit comments

Comments
 (0)