https://github.com/godoes/gorm-oracle
🅾️ A pure Go library for GORM Oracle driver based on sijms/go-ora. (forked from dzwvip/oracle - based on godror)
https://github.com/godoes/gorm-oracle
go go-gorm gorm oracle oracle-database
Last synced: about 2 months ago
JSON representation
🅾️ A pure Go library for GORM Oracle driver based on sijms/go-ora. (forked from dzwvip/oracle - based on godror)
- Host: GitHub
- URL: https://github.com/godoes/gorm-oracle
- Owner: godoes
- License: mit
- Created: 2022-09-19T07:39:01.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-09-13T01:28:35.000Z (6 months ago)
- Last Synced: 2025-09-13T03:24:00.291Z (6 months ago)
- Topics: go, go-gorm, gorm, oracle, oracle-database
- Language: Go
- Homepage: https://pkg.go.dev/github.com/godoes/gorm-oracle
- Size: 222 KB
- Stars: 79
- Watchers: 6
- Forks: 14
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# GORM Oracle Driver
## Description
GORM Oracle driver for connect Oracle DB and Manage Oracle DB, Based on [CengSin/oracle](https://github.com/CengSin/oracle)
and [sijms/go-ora](https://github.com/sijms/go-ora) (pure go oracle client)，*not recommended for use in a production environment*.
## Required dependency Install
- Oracle `11g` + (*`v1.6.3` and earlier versions support only `12c` +*)
- Golang
- `v1.6.1`: `go1.16` +
- `v1.6.2`: `go1.18` +
- gorm `1.24.0` +
## Quick Start
### How to install
```bash
go get -d github.com/godoes/gorm-oracle
```
### Usage
```go
package main
import (
oracle "github.com/godoes/gorm-oracle"
"gorm.io/gorm"
)
func main() {
options := map[string]string{
"CONNECTION TIMEOUT": "90",
"LANGUAGE": "SIMPLIFIED CHINESE",
"TERRITORY": "CHINA",
"SSL": "false",
}
// oracle://user:password@127.0.0.1:1521/service
url := oracle.BuildUrl("127.0.0.1", "1521", "service", "user", "password", options)
dialector := oracle.New(oracle.Config{
DSN: url,
IgnoreCase: false, // query conditions are not case-sensitive
NamingCaseSensitive: true, // whether naming is case-sensitive
VarcharSizeIsCharLength: true, // whether VARCHAR type size is character length, defaulting to byte length
// RowNumberAliasForOracle11 is the alias for ROW_NUMBER() in Oracle 11g, defaulting to ROW_NUM
RowNumberAliasForOracle11: "ROW_NUM",
})
db, err := gorm.Open(dialector, &gorm.Config{
SkipDefaultTransaction: true, // 是否禁用默认在事务中执行单次创建、更新、删除操作
DisableForeignKeyConstraintWhenMigrating: true, // 是否禁止在自动迁移或创建表时自动创建外键约束
// 自定义命名策略
NamingStrategy: schema.NamingStrategy{
NoLowerCase: true, // 是否不自动转换小写表名
IdentifierMaxLength: 30, // Oracle: 30, PostgreSQL:63, MySQL: 64, SQL Server、SQLite、DM: 128
},
PrepareStmt: false, // 创建并缓存预编译语句，启用后可能会报 ORA-01002 错误
CreateBatchSize: 50, // 插入数据默认批处理大小
})
if err != nil {
// panic error or log error info
}
// set session parameters
if sqlDB, err := db.DB(); err == nil {
_, _ = oracle.AddSessionParams(sqlDB, map[string]string{
"TIME_ZONE": "+08:00", // ALTER SESSION SET TIME_ZONE = '+08:00';
"NLS_DATE_FORMAT": "YYYY-MM-DD", // ALTER SESSION SET NLS_DATE_FORMAT = 'YYYY-MM-DD';
"NLS_TIME_FORMAT": "HH24:MI:SSXFF", // ALTER SESSION SET NLS_TIME_FORMAT = 'HH24:MI:SS.FF3';
"NLS_TIMESTAMP_FORMAT": "YYYY-MM-DD HH24:MI:SSXFF", // ALTER SESSION SET NLS_TIMESTAMP_FORMAT = 'YYYY-MM-DD HH24:MI:SS.FF3';
"NLS_TIME_TZ_FORMAT": "HH24:MI:SS.FF TZR", // ALTER SESSION SET NLS_TIME_TZ_FORMAT = 'HH24:MI:SS.FF3 TZR';
"NLS_TIMESTAMP_TZ_FORMAT": "YYYY-MM-DD HH24:MI:SSXFF TZR", // ALTER SESSION SET NLS_TIMESTAMP_TZ_FORMAT = 'YYYY-MM-DD HH24:MI:SS.FF3 TZR';
})
}
// do somethings
}
```
## Questions
ORA-01000: 超出打开游标的最大数
> ORA-00604: 递归 SQL 级别 1 出现错误
>
> ORA-01000: 超出打开游标的最大数
```shell
show parameter OPEN_CURSORS;
```
```sql
alter system set OPEN_CURSORS = 1000; -- or bigger
commit;
```
ORA-01002: 提取违反顺序
> 如果重复执行同一查询，第一次查询成功，第二次报 `ORA-01002` 错误，可能是因为启用了 `PrepareStmt`，关闭此配置即可。
推荐配置：
```go
&gorm.Config{
SkipDefaultTransaction: true, // 是否禁用默认在事务中执行单次创建、更新、删除操作
DisableForeignKeyConstraintWhenMigrating: true, // 是否禁止在自动迁移或创建表时自动创建外键约束
// 自定义命名策略
NamingStrategy: schema.NamingStrategy{
NoLowerCase: true, // 是否不自动转换小写表名
IdentifierMaxLength: 30, // Oracle: 30, PostgreSQL:63, MySQL: 64, SQL Server、SQLite、DM: 128
},
PrepareStmt: false, // 创建并缓存预编译语句，启用后可能会报 ORA-01002 错误
CreateBatchSize: 50, // 插入数据默认批处理大小
}
```
## Contributors
iTanken
stevefan1999-personal
CengSin
jinzhu
dzwvip
miclle
dk333
cloorc
## LICENSE
[MIT license](./LICENSE)
- Copyright (c) 2020 [Jinzhu](https://github.com/jinzhu)
- Copyright (c) 2020 [Steve Fan](https://github.com/stevefan1999-personal)
- Copyright (c) 2020 [CengSin](https://github.com/CengSin)
- Copyright (c) 2022 [dzwvip](https://github.com/dzwvip)
- Copyright (c) 2022-present [iTanken](https://github.com/iTanken)