create remote oracle odbc data source on win10

前言

用OCI编程时，OCIServerAttach连接的是用oracle客户端网络助手配置好的远端TNS服务名称.
可能不需要先配置好可用的数据源（未测试），但是可以用ODBC数据源中的测试功能，确定远端oracle数据库连接正常，才能继续OCI编程测试。

因为OCI编程时，需要连接的是远端的TNS服务名称，所以，oracle客户端工具是需要装的。然后配置监听器和远端网络服务名称。

实验环境

win10 + oracle client administrator tools + 一个在远端已经装好可用的oracle数据库.

实验

安装win64_11gR2_client.zip中的setup.exe, 安装时，选择第二项，“管理员工具”
找到客户端工具目录
C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Oracle - OraClient11g_home1\配置和移植工具。
配置oracle ODBC 数据源主要用到这个目录中的2个工具：

Net Configuration Assistant = D:\app\ls\product\11.2.0\client_1\BIN\launch.exe “D:\app\ls\product\11.2.0\client_1\bin” ..\bin\netca.cl

Microsoft ODBC 管理员 = C:\Windows\System32\odbcad32.exe
* 运行Net Configuration Assistant

**配置监听程序

执行完生成: D:\app\ls\product\11.2.0\client_1\network\admin\listener.ora

# listener.ora Network Configuration File: D:\app\ls\product\11.2.0\client_1\network\admin\listener.ora
# Generated by Oracle configuration tools.LISTENER =(DESCRIPTION_LIST =(DESCRIPTION =(ADDRESS = (PROTOCOL = TCP)(HOST = MY_HOST_NAME)(PORT = 1521))(ADDRESS = (PROTOCOL = IPC)(KEY = EXTPROC1521))))ADR_BASE_LISTENER = D:\app\ls

如果在客户端用ODBC向导添加远端oracle动态数据源时，测试时，显示没有合适的监听程序。
需要将listener.ora的HOST=MY_HOST_NAME, 是本地的hostname，而不是远端的IP。
在卸载时(deinstall.bat)，验证了，本地的oracle客户端确实开了监听。

**本地网络服务名配置

执行完生成：D:\app\ls\product\11.2.0\client_1\network\admin\tnsnames.ora

# tnsnames.ora Network Configuration File: D:\app\ls\product\11.2.0\client_1\network\admin\tnsnames.ora
# Generated by Oracle configuration tools.ORCL =(DESCRIPTION =(ADDRESS_LIST =(ADDRESS = (PROTOCOL = TCP)(HOST = 192.168.xx.xx)(PORT = 1521)))(CONNECT_DATA =(SERVICE_NAME = orcl)))

这里的服务名orcl，就是ODBC管理器中要用到的服务名，在下拉列表中可以选择.
tnsnames.ora中的HOST和PORT都是远端oracle数据库的IP和PORT。

运行Microsoft ODBC 管理员

这里用的远端数据库的服务名称都是在上一步tnsnames.ora中配置好的。

只要知道远端oracle数据库的用户名和口令，填入，点击测试，成功。
在客户端使用的oracle远程ODBC数据源就配置好了，在OCI编程时，就使用这个做好的odbc数据源名称。

配置好后，在客户端用 TNSPING ORCL 执行，会成功。

OCI测试代码

用OCIServerAttach连接远端TNS服务名称成功，说明OCI开发环境搭建成功。

// oci_test_on_vs2017.cpp : 定义控制台应用程序的入口点。
//#include "stdafx.h"
#include <stdlib.h>
#include <stdio.h>
#include <string.h>
#include <string>#include "oci.h"
// oci.lib is win64, win32编译不过.
#pragma comment(lib, "oci.lib")// 用oracle网络助手配置的远端网络服务名称, 不是ODBC助手配置出来的dsn名称
#define REMOTE_TNS_SERVICE_NAME "ORCL"void test_oci_a();int _tmain(int argc, _TCHAR* argv[])
{test_oci_a();printf("END\n");system("pause");return 0;
}void test_oci_a()
{sword sw_rc = 0;sword sw_tmp = 0;OCIEnv* myenvhp = NULL;OCIServer* mysrvhp = NULL;OCIError* myerrhp = NULL;OCISession* myusrhp = NULL;OCISvcCtx* mysvchp = NULL;sb4 errcode = 0;char sz_buf[4096] = {'\0'};do {sw_rc = OCIEnvCreate(&myenvhp, OCI_THREADED | OCI_OBJECT, (dvoid*)0, 0, 0, 0, (size_t)0, (dvoid**)0);if (OCI_SUCCESS != sw_rc) {break;}sw_rc = OCIHandleAlloc((dvoid*)myenvhp, (dvoid**)&mysrvhp, OCI_HTYPE_SERVER, 0, (dvoid**)0);if (OCI_SUCCESS != sw_rc) {break;}sw_rc = OCIHandleAlloc((dvoid*)myenvhp, (dvoid**)&myerrhp, OCI_HTYPE_ERROR, 0, (dvoid**)0);if (OCI_SUCCESS != sw_rc) {break;}// OCI连接的不是ODBC DSN名称// my_oracle_dsn// ORA-12154: TNS: 无法解析指定的连接标识符// OCI连接的是远端TNS服务名称// TNSPING ORCL// 成功sw_rc = OCIServerAttach(mysrvhp, myerrhp, (text*)REMOTE_TNS_SERVICE_NAME,(sb4)strlen(REMOTE_TNS_SERVICE_NAME),OCI_DEFAULT);if (OCI_SUCCESS != sw_rc) {printf("error : remote database connect\r\n");break;}printf("ok : remote database connect\r\n");} while (0);if ((OCI_SUCCESS != sw_rc) && (NULL != myerrhp)) {sw_tmp = OCIErrorGet(myerrhp, (ub4)1, (text*)NULL, &errcode,(OraText*)sz_buf, (ub4)sizeof(sz_buf), (b4)OCI_HTYPE_ERROR);if (OCI_SUCCESS == sw_tmp) {printf("%s\r\n", sz_buf);}}// @todo 资源释放}