Enum SqlType 

pub enum SqlType {
    Bool,
    BigInt,
    SmallInt,
    Int,
    Numeric {
        precision: u32,
        scale: u32,
    },
    Double,
    Float,
    Oid,
    ByteA,
    Text,
    Varchar {
        max_length: Option<u32>,
    },
    Char {
        length: u32,
    },
    Json,
    Date,
    Interval,
    Time,
    Timestamp,
    TimestampTz,
    Geography,
    Unsupported,
}

SQL type tags that identify the type of a column.

Each variant corresponds to a Hyper SQL type and has an associated internal OID.

Example

use hyperdb_api_core::types::SqlType;

let int_type = SqlType::int();
assert_eq!(int_type.to_string(), "INTEGER");

let numeric_type = SqlType::numeric(18, 2);
assert_eq!(numeric_type.to_string(), "NUMERIC(18, 2)");

Variants

Bool

Boolean type.

BigInt

64-bit integer (BIGINT).

SmallInt

16-bit integer (SMALLINT).

Int

32-bit integer (INT).

Numeric

Numeric/decimal type with precision and scale.

Fields

precision: u32

Total number of digits (1-38).

scale: u32

Number of digits after decimal point (0-precision).

Double

Double precision floating point.

Float

Single precision floating point.

Oid

Object identifier.

ByteA

Binary data (BYTEA).

Text

Variable-length text.

Varchar

Variable-length character string with max length.

Fields

max_length: Option<u32>

Maximum length, or None for unlimited.

Char

Fixed-length character string.

Fields

length: u32

Fixed length.

Json

JSON data.

Date

Date (year, month, day).

Interval

Time interval.

Time

Time of day.

Timestamp

Timestamp without timezone.

TimestampTz

Timestamp with timezone.

Geography

Geography/geometric data.

Unsupported

Unsupported type.

Implementations

impl SqlType

pub fn bool() -> SqlType

Creates a Bool type.

Example

use hyperdb_api_core::types::SqlType;
let t = SqlType::bool();
assert_eq!(t.to_string(), "BOOLEAN");

pub fn big_int() -> SqlType

Creates a BigInt type.

Example

use hyperdb_api_core::types::SqlType;
let t = SqlType::big_int();
assert_eq!(t.to_string(), "BIGINT");

pub fn small_int() -> SqlType

Creates a SmallInt type.

Example

use hyperdb_api_core::types::SqlType;
let t = SqlType::small_int();
assert_eq!(t.to_string(), "SMALLINT");

pub fn int() -> SqlType

Creates an Int type.

Example

use hyperdb_api_core::types::SqlType;
let t = SqlType::int();
assert_eq!(t.to_string(), "INTEGER");

pub fn numeric(precision: u32, scale: u32) -> SqlType

Creates a Numeric type with the given precision and scale.

Arguments

• precision - Total number of digits (1-38)
• scale - Number of digits after decimal point (0-precision)

Panics

Panics if precision is not in 1..=38 or scale > precision.

Example

use hyperdb_api_core::types::SqlType;
let t = SqlType::numeric(18, 2);
assert_eq!(t.to_string(), "NUMERIC(18, 2)");

pub fn double() -> SqlType

Creates a Double type.

Example

use hyperdb_api_core::types::SqlType;
let t = SqlType::double();
assert_eq!(t.to_string(), "DOUBLE PRECISION");

pub fn float() -> SqlType

Creates a Float type.

Example

use hyperdb_api_core::types::SqlType;
let t = SqlType::float();
assert_eq!(t.to_string(), "REAL");

pub fn oid() -> SqlType

Creates an Oid type.

pub fn text() -> SqlType

Creates a Text type.

Example

use hyperdb_api_core::types::SqlType;
let t = SqlType::text();
assert_eq!(t.to_string(), "TEXT");

pub fn varchar(max_length: Option<u32>) -> SqlType

Creates a Varchar type with optional max length.

Example

use hyperdb_api_core::types::SqlType;
let t = SqlType::varchar(Some(255));
assert_eq!(t.to_string(), "VARCHAR(255)");

pub fn char(length: u32) -> SqlType

Creates a Char type with the given length.

Example

use hyperdb_api_core::types::SqlType;
let t = SqlType::char(10);
assert_eq!(t.to_string(), "CHAR(10)");

pub fn date() -> SqlType

Creates a Date type.

Example

use hyperdb_api_core::types::SqlType;
let t = SqlType::date();
assert_eq!(t.to_string(), "DATE");

pub fn time() -> SqlType

Creates a Time type.

Example

use hyperdb_api_core::types::SqlType;
let t = SqlType::time();
assert_eq!(t.to_string(), "TIME");

pub fn timestamp() -> SqlType

Creates a Timestamp type.

Example

use hyperdb_api_core::types::SqlType;
let t = SqlType::timestamp();
assert_eq!(t.to_string(), "TIMESTAMP");

pub fn timestamp_tz() -> SqlType

Creates a TimestampTz type.

Example

use hyperdb_api_core::types::SqlType;
let t = SqlType::timestamp_tz();
assert_eq!(t.to_string(), "TIMESTAMPTZ");

pub fn interval() -> SqlType

Creates an Interval type.

pub fn bytes() -> SqlType

Creates a ByteA (binary) type.

Example

use hyperdb_api_core::types::SqlType;
let t = SqlType::bytes();
assert_eq!(t.to_string(), "BYTEA");

pub fn json() -> SqlType

Creates a Json type.

Example

use hyperdb_api_core::types::SqlType;
let t = SqlType::json();
assert_eq!(t.to_string(), "JSON");

pub fn geography() -> SqlType

Creates a Geography type.

Note: tabgeography() is the preferred method name to match C++ and Java APIs.

pub fn tabgeography() -> SqlType

Creates a TabGeography type (Tableau geography).

This is the preferred method for creating geography columns, matching the C++ and Java API naming conventions.

Example

use hyperdb_api_core::types::SqlType;
let t = SqlType::tabgeography();
assert_eq!(t.to_string(), "GEOGRAPHY");

pub fn internal_oid(&self) -> u32

Returns the internal OID for this SQL type.

The internal OID is used by Hyper’s protocol layer for type identification.

Example

use hyperdb_api_core::types::SqlType;
let t = SqlType::int();
assert_eq!(t.internal_oid(), 23);

pub fn precision(&self) -> Option<u32>

Returns the precision for Numeric types, or None for other types.

pub fn scale(&self) -> Option<u32>

Returns the scale for Numeric types, or None for other types.

pub fn max_length(&self) -> Option<u32>

Returns the max length for Varchar/Char types, or None for other types.

pub fn from_oid(oid: u32) -> SqlType

Creates a SqlType from an OID.

Example

use hyperdb_api_core::types::SqlType;
let t = SqlType::from_oid(23);
assert_eq!(t, SqlType::Int);

pub fn from_oid_and_modifier(oid: u32, modifier: i32) -> SqlType

Creates a SqlType from an OID and type modifier.

Type modifiers encode additional information like precision/scale for numeric types or max length for varchar types.

For NUMERIC types, the modifier format is: ((precision << 16) | scale) + 4. Valid modifiers are >= 4 (since minimum valid precision is 1 and scale is 0). Malformed modifiers (values 1-3, or values producing precision > 38 or scale > precision) are treated as unspecified (precision=0, scale=0).

Panics

Does not panic in practice. The NUMERIC, VARCHAR, and CHAR branches each convert modifier - 4 to u32 via try_from().expect(...) guarded by a modifier < 4 check, so the subtraction is always non-negative.

pub fn is_numeric(&self) -> bool

Returns true if this type is a numeric type (can store numbers).

pub fn is_string(&self) -> bool

Returns true if this type is a string type.

pub fn is_temporal(&self) -> bool

Returns true if this type is a temporal type.

pub fn is_unsupported(&self) -> bool

Returns true if this is an unsupported type.

Trait Implementations

impl Clone for SqlType

fn clone(&self) -> SqlType

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SqlType

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for SqlType

fn default() -> SqlType

Returns the “default value” for a type.

impl Display for SqlType

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl PartialEq for SqlType

fn eq(&self, other: &SqlType) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for SqlType

impl Eq for SqlType

impl StructuralPartialEq for SqlType