OceanBase logo

OceanBase

A unified distributed database ready for your transactional, analytical, and AI workloads.

Product Overview
DEPLOY YOUR WAY

OceanBase Cloud

The best way to deploy and scale OceanBase

OceanBase Enterprise

Run and manage OceanBase on your infra

TRY OPEN SOURCE

OceanBase Community Edition

The free, open-source distributed database

OceanBase seekdb

Open source AI native search database

Customer Stories

Real-world success stories from enterprises across diverse industries.

View All
BY USE CASES

Mission-Critical Transactions

Global & Multicloud Application

Elastic Scaling for Peak Traffic

Real-time Analytics

Active Geo-redundancy

Database Consolidation

Resources

Comprehensive knowledge hub for OceanBase.

Blog

Live Demos

Training & Certification

Documentation

Official technical guides, tutorials, API references, and manuals for all OceanBase products.

View All
PRODUCTS

OceanBase Cloud

OceanBase Database

Tools

Connectors and Middleware

QUICK START

OceanBase Cloud

OceanBase Database

BEST PRACTICES

Practical guides for utilizing OceanBase more effectively and conveniently

Company

Learn more about OceanBase – our company, partnerships, and trust and security initiatives.

About OceanBase

Partner

Trust Center

Contact Us

International - English
中国站 - 简体中文
日本 - 日本語
Sign In
Start on Cloud

OceanBase

A unified distributed database ready for your transactional, analytical, and AI workloads.

Product Overview
DEPLOY YOUR WAY

OceanBase Cloud

The best way to deploy and scale OceanBase

OceanBase Enterprise

Run and manage OceanBase on your infra

TRY OPEN SOURCE

OceanBase Community Edition

The free, open-source distributed database

OceanBase seekdb

Open source AI native search database

Customer Stories

Real-world success stories from enterprises across diverse industries.

View All
BY USE CASES

Mission-Critical Transactions

Global & Multicloud Application

Elastic Scaling for Peak Traffic

Real-time Analytics

Active Geo-redundancy

Database Consolidation

Comprehensive knowledge hub for OceanBase.

Blog

Live Demos

Training & Certification

Documentation

Official technical guides, tutorials, API references, and manuals for all OceanBase products.

View All
PRODUCTS
OceanBase CloudOceanBase Database
ToolsConnectors and Middleware
QUICK START
OceanBase CloudOceanBase Database
BEST PRACTICES

Practical guides for utilizing OceanBase more effectively and conveniently

Learn more about OceanBase – our company, partnerships, and trust and security initiatives.

About OceanBase

Partner

Trust Center

Contact Us

Start on Cloud
编组
All Products
    • Databases
    • iconOceanBase Database
    • iconOceanBase Cloud
    • iconOceanBase Tugraph
    • iconInteractive Tutorials
    • iconOceanBase Best Practices
    • Tools
    • iconOceanBase Cloud Platform
    • iconOceanBase Migration Service
    • iconOceanBase Developer Center
    • iconOceanBase Migration Assessment
    • iconOceanBase Admin Tool
    • iconOceanBase Loader and Dumper
    • iconOceanBase Deployer
    • iconKubernetes operator for OceanBase
    • iconOceanBase Diagnostic Tool
    • iconOceanBase Binlog Service
    • Connectors and Middleware
    • iconOceanBase Database Proxy
    • iconEmbedded SQL in C for OceanBase
    • iconOceanBase Call Interface
    • iconOceanBase Connector/C
    • iconOceanBase Connector/J
    • iconOceanBase Connector/ODBC
    • iconOceanBase Connector/NET
icon

Embedded SQL in C for OceanBase

V1.1.7Enterprise Edition

  • What's New
  • What is ECOB?
  • ECOB compatibility with Pro*C
  • Install ECOB
  • Data types and variables
    • Overview
    • Supported data types
    • Data type conversion
    • Indicator variable
    • VARCHAR variable
    • Structure
    • String pointer
  • Embedded SQL statements
    • Overview
    • Variable declaration
    • Connect to OceanBase databases
    • Basic SQL statements
    • Prepared statements
    • Stored procedures
    • Cursor
    • Simple dynamic SQL statement
    • ANSI dynamic SQL statements
    • Error handling
      • SQLCA structure
      • WHENEVER statement
    • LOB-related SQL statements
  • Use ECOB
    • Environment preparation
    • Use ECOB
    • Compile the Tuxedo service
  • Command Line Options

Download PDF

What's New What is ECOB? ECOB compatibility with Pro*C Install ECOB Overview Supported data types Data type conversion Indicator variable VARCHAR variable Structure String pointer Overview Variable declaration Connect to OceanBase databases Basic SQL statements Prepared statements Stored procedures Cursor Simple dynamic SQL statement ANSI dynamic SQL statements SQLCA structure WHENEVER statement LOB-related SQL statements Environment preparation Use ECOB Compile the Tuxedo service Command Line Options
OceanBase logo

The Unified Distributed Database for the AI Era.

Follow Us
Products
OceanBase CloudOceanBase EnterpriseOceanBase Community EditionOceanBase seekdb
Resources
DocsBlogLive DemosTraining & Certification
Company
About OceanBaseTrust CenterLegalPartnerContact Us
Follow Us

© OceanBase 2026. All rights reserved

Cloud Service AgreementPrivacy PolicySecurity
Contact Us
Document Feedback
  1. Documentation Center
  2. Embedded SQL in C for OceanBase
  3. V1.1.7
iconEmbedded SQL in C for OceanBase
V 1.1.7Enterprise Edition

Supported data types

Last Updated:2023-06-29 11:12:55  Updated
share
What is on this page
Internal data types
External data types

folded

share

#docslug#/ecob/ecob/V1.1.6/supported-data-types OceanBase Embedded SQL in C (ECOB) supports internal data types of Oracle and external data types of C language.

Internal data types

The internal data types of ECOB refer to the data types that can be used in OceanBase databases. The following table describes internal data types that are supported by ECOB.

Internal data type Description
CHAR A string with a fixed length. Maximum length: 2,000 bytes.
VARCHAR2 A string with a changeable length. Maximum length: 32,767 bytes.
NUMBER The numeric data type. Valid values of bits: -84 to 127. The value precision can be 1 to 38.
INT The integer data type. Maximum bits: 38.
BINARY_FLOAT A 32-bit floating-point number. Value values: [1.17549E-38F, 3.40282E+38F].
BINARY_DOUBLE A 64-bit floating-point number. Value values: [2.22507485850720E-308, 1.79769313486231E+308].
DATE The date type. Format: YYYY-MM-DD HH:MI:SS.
TIMESTAMP The timestamp type. Format: YYYY-MM-DD HH:MI:SS [.FFFFFFFFF].

Note

You can only insert TIMESTAMP data. The TIMESTAMP data cannot be written to or read from variables in C language.

External data types

The external data types of ECOB are used to specify the storage types of host variables, which are the data types of C language. When you write data into OceanBase databases, ECOB converts the external data types of host variables into internal data types. When you export data to an external application, ECOB converts the internal data types of OceanBase databases into external data types of host variables.

ECOB supports the conversion of host variable types such as integers, float points, and characters. ECOB also supports complex data types such as STRUCT.

Notice

You can add all supported data types into STRUCT. However, we recommend that you do not nest STRUCT in STRUCT.

The following table describes the external data types supported by ECOB and the mapping between them and host variable types.

External data type Description Host variable data type
ECOBt_char Stores long strings with a fixed length. char, char *, and char []
ECOBt_unsigned_char Stores long strings with a fixed length. unsigned char
ECOBt_short Stores signed short integers. int, int *, and int[]
ECOBt_unsigned_short Stores unsigned short integers. unsigned int
ECOBt_int Stores signed integers. short, short *, and short[]
ECOBt_unsigned_int Stores unsigned integers. unsigned short
ECOBt_long Stores signed long integers. long, long *, and long[]
ECOBt_unsigned_long Stores unsigned long integers. unsigned long
ECOBt_long_long Stores signed long long integers. long long, long long *, and long long[]
ECOBt_unsigned_long_long Stores unsigned long long integers. unsigned long long
ECOBt_float Stores 32-bit float numbers. float, float *, and float[]
ECOBt_double Stores 64-bit float numbers. double, double *, and double[]
ECOBt_varchar Stores strings with a variable length. varchar varchar * varchar[]
ECOBt_struct Stores structures. struct, struct *, and struct[]

Previous topic

Overview
Last

Next topic

Data type conversion
Next
What is on this page
Internal data types
External data types