异常处理
所有文档

          云数据库 RDS

          异常处理

          GO语言以error类型标识错误,RDS支持两种错误见下表:

          错误类型 说明
          BceClientError 用户操作产生的错误
          BceServiceError RDS服务返回的错误

          用户使用SDK调用RDS相关接口,除了返回所需的结果之外还会返回错误,用户可以获取相关错误进行处理。实例如下:

          // rdsClient 为已创建的RDS Client对象
          result, err := client.ListRds()
          if err != nil {
          	switch realErr := err.(type) {
          	case *bce.BceClientError:
          		fmt.Println("client occurs error:", realErr.Error())
          	case *bce.BceServiceError:
          		fmt.Println("service occurs error:", realErr.Error())
          	default:
          		fmt.Println("unknown error:", err)
          	}
          } 

          客户端异常

          客户端异常表示客户端尝试向RDS发送请求以及数据传输时遇到的异常。例如,当发送请求时网络连接不可用时,则会返回BceClientError。

          服务端异常

          当RDS服务端出现异常时,RDS服务端会返回给用户相应的错误信息,以便定位问题。

          SDK日志

          RDS GO SDK支持六个级别、三种输出(标准输出、标准错误、文件)、基本格式设置的日志模块,导入路径为github.com/baidubce/bce-sdk-go/util/log。输出为文件时支持设置五种日志滚动方式(不滚动、按天、按小时、按分钟、按大小),此时还需设置输出日志文件的目录。

          默认日志

          RDS GO SDK自身使用包级别的全局日志对象,该对象默认情况下不记录日志,如果需要输出SDK相关日志需要用户自定指定输出方式和级别,详见如下示例:

          // import "github.com/baidubce/bce-sdk-go/util/log"
          
          // 指定输出到标准错误,输出INFO及以上级别
          log.SetLogHandler(log.STDERR)
          log.SetLogLevel(log.INFO)
          
          // 指定输出到标准错误和文件,DEBUG及以上级别,以1GB文件大小进行滚动
          log.SetLogHandler(log.STDERR | log.FILE)
          log.SetLogDir("/tmp/gosdk-log")
          log.SetRotateType(log.ROTATE_SIZE)
          log.SetRotateSize(1 << 30)
          
          // 输出到标准输出,仅输出级别和日志消息
          log.SetLogHandler(log.STDOUT)
          log.SetLogFormat([]string{log.FMT_LEVEL, log.FMT_MSG})

          说明:

          1. 日志默认输出级别为`DEBUG`
          2. 如果设置为输出到文件,默认日志输出目录为`/tmp`,默认按小时滚动
          3. 如果设置为输出到文件且按大小滚动,默认滚动大小为1GB
          4. 默认的日志输出格式为:`FMT_LEVEL, FMT_LTIME, FMT_LOCATION, FMT_MSG`

          项目使用

          该日志模块无任何外部依赖,用户使用GO SDK开发项目,可以直接引用该日志模块自行在项目中使用,用户可以继续使用GO SDK使用的包级别的日志对象,也可创建新的日志对象,详见如下示例:

          // 直接使用包级别全局日志对象(会和GO SDK自身日志一并输出)
          log.SetLogHandler(log.STDERR)
          log.Debugf("%s", "logging message using the log package in the RDS go sdk")
          
          // 创建新的日志对象(依据自定义设置输出日志,与GO SDK日志输出分离)
          myLogger := log.NewLogger()
          myLogger.SetLogHandler(log.FILE)
          myLogger.SetLogDir("/home/log")
          myLogger.SetRotateType(log.ROTATE_SIZE)
          myLogger.Info("this is my own logger from the RDS go sdk")
          上一篇
          其他接口
          下一篇
          知识库