gbase数据、南大通用产品文档：GBase8sha sds primary 参数：

将 SD 辅助服务器转换
到主服务器（SQL 管理 API）
随同 admin() 或 task() 函数，使用 ha sds primary 参数来将共享磁盘（SD）辅助服务
器更改为主服务器。
语法


GBase 8s 管理员参考
南大通用数据技术股份有限公司 - 746 -
元素
描述
关键考虑
secondary_server
要设置作为主服务器的 SD 辅
助服务器的名称。
必须在 DBSERVERNAME 或
DBSERVERALIASES 配置参数中
定义该名称，或作为
Enterprise Replication 组
名。

用法
在已建立的 SD 辅助服务器上运行这个函数来将其转换到主服务器。
使用 ha sds primary 参数来将不活动的 SD 辅助服务器转换到主服务器，如果该 SD 辅
助服务器连接到它。
使用 ha sds primary force 参数来将不活动的 SD 辅助服务器转换为主服务器，无论是
否有任何 SD 辅助服务器连接到它。如果会话是活动的，则调用成功，但共享磁盘子系统
可被损坏。
这个函数等同于 onmode -d make primary 命令。
示例
下列示例将名为 ids_stores3 的 SD 辅助服务器转换到主服务器：
EXECUTE FUNCTION task("ha sds primary","ids_stores3");

ifx_int8toasc() 函数将 int8 类型数值转换为 C char 类型值。
语法

mint ifx_int8toasc(int8_val, strng_val, len)
ifx_int8_t *int8_val;

GBase 8s ESQL/C 编程指南
南大通用数据技术股份有限公司
- 747 -

char *strng_val;
mint len;
int8_val
指向 ifx_int8toasc() 将其值转换为文本字符串的 int8 结构的指针。
strng_val
指向 ifx_int8toasc() 放置文本字符串处的字符缓冲区的第一个字节的指针。
len
以字节计算的 strng_val 的大小，对于空终止符，为负 1。
用法
如果 int8 数值不适于放入长度 len 的字符串内，则 ifx_int8toasc() 将该数值转换为
指数计数法。如果该值仍不适合，则 ifx_int8toasc() 以星号填充字符串。 如果该数值比字
符串短，则 ifx_int8toasc() 向左对齐该数值，并用空格填充它的右边。
由于 ifx_int8toasc() 返回的字符串不是以空终止的，因此，在您打印它之前，您必须
将空字符添加到该字符串。
当您使用非缺省的语言环境（US English 之外的一种）时，ifx_int8toasc() 支持
strng_val 字符串中的非 ASCII 字符。要获取更多信息，
返回代码
0
转换成功。
-1207
被转换的值不适于放入分配了的空间内。
示例
demo 目录中的文件 int8toasc.ec 包含下列样例程序。
/*
* ifx_int8toasc.ec *

The following program converts three string
constants to INT8 types and then uses ifx_int8toasc()
to convert the INT8 values to C char type values.
*/

#include
#define END sizeof(result)

GBase 8s ESQL/C 编程指南
南大通用数据技术股份有限公司
- 748 -


EXEC SQL include "int8.h";

char string1[] = "-12,555,444,333,786,456";
char string2[] = "480";
char string3[] = "5.2";
char result[40];

main()
{
mint x;
ifx_int8_t num1, num2, num3;

printf("IFX_INT8tOASC Sample ESQL Program running.\n\n");

if (x = ifx_int8cvasc(string1, strlen(string1), &num1))
{
printf("Error %d in converting string1 to INT8\n", x);
exit(1);
}
if (x = ifx_int8cvasc(string2, strlen(string2), &num2))
{
printf("Error %d in converting string2 to INT8\n", x);
exit(1);
}
if (x = ifx_int8cvasc(string3, strlen(string3), &num3))
{
printf("Error %d in converting string3 to INT8\n", x);
exit(1);
}
printf("\nConverting INT8 back to ASCII\n");
printf(" Executing: ifx_int8toasc(&num1, result, END - 1)");
if (x = ifx_int8toasc(&num1, result, END - 1))

GBase 8s ESQL/C 编程指南
南大通用数据技术股份有限公司
- 749 -

printf("\tError %d in converting INT8 to string\n", x);
else
{
result[END - 1] = '\0'; /* null terminate */
printf("\n The value of the first INT8 is = %s\n", result);
}
printf("\nConverting second INT8 back to ASCII\n");
printf(" Executing: ifx_int8toasc(&num2, result, END - 1)");
if (x= ifx_int8toasc(&num2, result, END - 1))
printf("\tError %d in converting INT8 to string\n", x);
else
{
result[END - 1] = '\0'; /* null terminate */
printf("\n The value of the 2nd INT8 is = %s\n", result);
}

printf("\nConverting third INT8 back to ASCII\n");
printf(" Executing: ifx_int8toasc(&num3, result, END - 1)");
/* note that the decimal is truncated */

if (x= ifx_int8toasc(&num3, result, END - 1))
printf("\tError %d in converting INT8 to string\n", x);
else
{
result[END - 1] = '\0'; /* null terminate */
printf("\n The value of the 3rd INT8 is = %s\n", result);
}
printf("\nIFX_INT8tOASC Sample Program over.\n\n");
exit(0);
}
输出

IFX_INT8tOASC Sample ESQL Program running.

GBase 8s ESQL/C 编程指南
南大通用数据技术股份有限公司
- 750 -



Converting INT8 back to ASCII
Executing: ifx_int8toasc(&num1, result, sizeof(result)-1)
The value of the first INT8 is = -12555444333786456

Converting second INT8 back to ASCII
Executing: ifx_int8toasc(&num2, result, sizeof(result)-1)
The value of the 2nd INT8 is = 480

Converting third INT8 back to ASCII
Executing: ifx_int8toasc(&num3, result, END)
The value of the 3rd INT8 is = 5

GBA-01BR-0078
错误码
错误标识
错误显示信息
GBA-01BR-0078
无
Recover Table MetaFile Error
错误出现原因
恢复表元数据文件失败
分析与建议
1，检查表备份数据中元数据的正确性
2，检查文件系统权限及状态