数据类型映射
下方的列表显示了可用的数据类型及其映射。
注： 由于 Spotfire 和数据函数引擎中使用的数据类型略有不同，因此在来回发送数据时完成的转换过程可能会导致值非常大时影响值的精度。
数据维度
| Spotfire 数据 | Spotfire® Enterprise Runtime for R（又名 TERR™）/ R 数据 |
|---|---|
| 值 | 长度 1 的矢量（时间日期列表） |
| 列 | 矢量（时间日期列表） |
| 数据表 | data.frame |
从 Spotfire 发送并由 TERR 接收的数据类型
| Spotfire 数据类型 | TERR 和 R 的类 |
|---|---|
| Real | numeric |
| Integer | integer |
| LongInteger | numeric |
| SingleReal | numeric |
| Currency | numeric |
| String | 编码为 UTF-8 的字符 |
| DateTime | 使用时区 UTC 的 POSIXct |
| Date | 使用时区 UTC 的 POSIXct |
| Time | 使用时区 UTC 的 POSIXct，给定时间为 1970 年 1 月 1 日 |
| Boolean | logical |
| Binary | raw |
- 从 TERR 引擎或开源 R 引擎接收的 POSIXct 或 POSIXlt 始终作为 DateTime 存储在 Spotfire 中。
- 开源 R 因子作为字符串从 Spotfire Statistics Services 中发出。
- TERR 因子作为字符串从 TERR 中发出。
- 不支持上述之外的其他数据类型。
从 Spotfire 发送并由 TERR 接收的数据类型
| TERR 发送的 Spotfire 数据类型 | 导入到 Spotfire 中的数据类型 |
|---|---|
| logical | Boolean |
| integer | Integer (32 bit) |
| numeric | Real |
| character | String |
| factor | String |
| POSIXct 或 POSIXlt | DateTime |
| difftime | TimeSpan |
| raw | Binary |
- 有关将 SBDF 数据类型中的 TERR/R 数据导出到 Spotfire 的详细信息，请参见 TERR 库参考 SpotfireData::exportDataToSBDF。
- 有关从 Spotfire 导入 SBDF 内容的详细信息，请参见 TERR 库参考 SpotfireData::importDataFromSBDF。
- 有关设置 SBDF 数据类型的详细信息，请参见 TERR 库参考 SpotfireData::setSBDFExportTypes。注： 导出包含空字符串列的 SBDF 会导致 Pandas 和 Numpy 出错。有关如何导出空字符串列的信息，请参阅Spotfire 中的 Python 数据函数指南中的“对 SBDF 导出中的空字符串错误进行故障排除”。
从 Spotfire 发送并由 Python 和 Pandas 接收的数据类型
| 从 Spotfire 导出的数据类型 | Python 接收的数据类型 | Pandas 列 dtype |
|---|---|---|
| Real | float | float64 |
| Integer | int | Int32 |
| LongInteger | int | Int64 |
| SingleReal | float | float32 |
| Currency | decimal.Decimal | object |
| String | str | object |
| DateTime | datetime.datetime | object |
| Date | datetime.date | object |
| Time | datetime.time | object |
| Boolean | bool | object |
| Binary | bytes | object |
- Spotfire 列在 Python 中映射为 Pandas Series 类型。
- Spotfire 表在 Python 中映射为 Pandas DataFrame 类型。
从 Python 发送并导入到 Spotfire 中的数据类型
| Python 发送的数据类型 | 导入到 Spotfire 中的数据类型 |
|---|---|
| int | LongInteger |
| float | Real |
| decimal.Decimal | Currency |
| datetime.date | Date |
| datetime.datetime | DateTime |
| datetime.time | Time |
| datetime.timedelta | |
| bool | Boolean |
| str | String |
| bytes | Binary |
支持无效的值
Spotfire 中的所有数字无效值在 TERR 和开源 R 引擎中均以 NA 表示。对其他类型的无效值不提供特殊支持；它们在 TERR 和开源 R 引擎中将变为有效的默认值。
调用惯例函数
数据函数输入参数的名称必须与 TERR 和开源 R 函数参数的名称匹配。
对于仅返回一个值（不是值列表）的函数，系统会将单个数据函数输出参数与该返回值匹配。
对于返回值列表的函数，数据函数输出参数必须与列表元素的名称相匹配。
关于 R
R 在遵守单独的开源软件许可条款的前提下提供，并不是 Spotfire 的一部分。因此，R 不在您的 Spotfire 的许可范围内。Cloud Software Group, Inc. 不以任何形式对 R 提供支持、维护或保证。对 R 的下载和使用由您全权决定，且需遵守适用于 R 的免费开源许可条款。