Documentation
搜索文档
karat

+

K

API 参考 ↗
分析代码工作区RStudio® 工作台

注意：以下翻译的准确性尚未经过验证。这是使用 AIP ↗ 从原始英文文本进行的机器翻译。

RStudio® 工作台

要使用 RStudio® 工作台，您的平台管理员必须首先在控制面板中配置其操作许可证。

代码工作区使您能够在 Foundry 中使用 RStudio® 工作台 ↗。代码工作区中的 RStudio® 工作台支持：

  • 使用 Palantir R SDK ↗ 读取和写入表格数据集。
  • 从非结构化数据集中下载或上传文件。
  • 从 CRAN、Posit™ 包管理器和 Bioconductor 导入 R 包。
  • 发布 Shiny® 应用程序。
  • 发布 R 变换。

代码工作区目前支持 R 应用程序的 Shiny® ↗。用户可以直接在代码工作区中创建应用程序，并内置 Foundry 的版本控制、分支和数据治理功能。

代码工作区应用程序支持分支。如果您创建一个新的工作区分支，发布新应用程序或同步更改将会在该分支上发布应用程序的新版本。这使您能够在将应用程序公开给用户之前预览它。要在主分支上发布，只需将您的分支合并到主分支即可。

Shiny®

使用代码工作区，您可以创建一个 Shiny® 应用程序并直接从 RStudio® UI 预览它。

默认情况下，RStudio® 在主文件夹 (/home/user) 中生成 Shiny® 应用程序，但 Foundry 要求应用程序位于 git 仓库 /home/user/repo 中，以便在会话之间持久化并发布。

在代码工作区中，选择 发布应用程序，在您的 文件和项目 中选择新应用程序的位置，并输入应相对于仓库根目录 /home/user/repo 自动创建新 Shiny® app.R 文件的目录名称。此字段可以留空，以在仓库根目录创建应用程序。默认情况下，应用程序设置将匹配 RStudio® 工作区设置，配置高级设置是非必填的。

已发布的 Shiny 应用程序受到 30 秒超时的限制，这意味着 Shiny 服务器必须在执行 Shiny 应用程序文件后的 30 秒内启动。否则，您的 Shiny 应用程序将无法启动。

选择 发布并同步 以注册您的新 Shiny® 应用程序并同步代码到支持代码仓库。完成 CI 检查和发布后，您可以在应用程序面板中选择链接以查看已发布的应用程序。

要在本地开发针对 Shiny® 应用程序：

  1. 在 RStudio® 中打开 app.R。
  2. 选择 运行应用。您的应用程序的预览将出现在新窗口中。

配置 Shiny® 应用程序以自动重新连接

默认情况下，如果 websocket 连接关闭，例如网络中断超过 15 秒，Shiny 会变灰。为了确保您的应用程序在网络连接恢复时能够恢复，我们建议更新 server 函数以设置 session$allowReconnect("force")：

Copied!
1
2
3
4
server <- function(input, output, session) {
  # 处理输入更改
  session$allowReconnect("force") # 强制允许会话重新连接
}

当网络再次可用时，这将导致前端触发一个新的websocket，并发送在UI中设置的最后输入信息。

R 变换

目前，R 变换不支持对外部服务的API调用，即使在RStudio代码工作区中添加了网络策略。

在代码工作区中编写的R脚本可以注册为代码工作区中输出数据集的变换。

按照以下步骤为输出数据集注册变换：

  1. 在数据面板中，选择数据集旁边的蓝色搭建图标。
数据集名称右侧的蓝色搭建按钮。
  1. 按照界面配置您的变换。代码工作区会推断所使用的R脚本以及用于生成输出数据集的输入。
编辑变换面板，提供修改脚本文件、输入和输出及调整CPU和内存的选项。
  1. 选择同步并运行以保存变换配置，并触发CI检查以发布变换和输出数据集上的任务规格。

一旦CI检查完成，您的变换就可以准备搭建。然后，您可以使用其他Foundry 数据集成工具来管理您的变换及其所属的数据管道。

变换不会自动使用代码工作区的环境。您应该在脚本文件的顶部安装所有运行时所需的包。安装包的代码片段可以在包面板中找到。 例如，要在您的变换中使用dplyr和tidyr，请将此代码片段添加到文件顶部：

Copied!
1
2
3
4
renv::install(c("dplyr", "tidyr"))
# 使用 renv 包安装指定的 R 包
# dplyr：用于数据操作的包
# tidyr：用于整理数据的包

了解更多关于R变换的信息。

RStudio® 和 Shiny® 是 Posit™ 的商标。

所有提到的第三方商标（包括标识和图标）均为其各自所有者的财产。未暗示任何附属关系或认可。

R Markdown 报告

在 RStudio® 工作区中编写的 R Markdown 文件可以通过 R Markdown 报告与其他 Palantir 平台用户共享。报告是通过使用变换从 R Markdown 文件搭建的数据集，其中包含通过 Quarto ↗ 渲染 R Markdown 文件生成的 HTML。

报告是使用变换搭建的，因此可以配置为根据 R Markdown 文件的最新更改自动更新，使用 计划。这确保了您的分析和可视化是最新的，并且通过可重现、可定制的工作流程搭建，与 Palantir 平台的其他部分集成。

Code Workspaces 中的报告侧边栏。

从 RStudio® 工作区发布报告

可以通过以下步骤在 RStudio® 工作区中发布 R Markdown 报告：

  1. 创建您希望用来搭建输入的 R Markdown 文件。此 R Markdown 文件可以从已通过 数据侧边栏 添加到您的工作区的 Foundry 数据集中读取数据。
  2. 打开 应用程序 侧边栏并选择 报告 标签。
  3. 选择 添加 以打开报告配置对话框。
  4. 提供名称和位置；这决定了包含报告的数据集将被保存的位置。
  5. 选择 R Markdown 文件以搭建您的报告。如果您的 R Markdown 从 Foundry 数据集中读取，请将这些数据集添加为报告输入。选择 自动配置输入和输出 以自动解析您的 R Markdown 文件，并使用检测到的数据集填充表单。
  6. 选择 创建。这将在指定位置创建一个数据集。搭建报告的变换将运行。请注意，这可能需要几分钟才能完成。
  7. 报告搭建完成后，在 应用程序 侧边栏中选择报告名称以在新选项卡中打开报告。此链接可以与其他用户共享。

要编辑或删除现有报告，请在报告卡片右侧选择 ...。这将打开一个菜单，其中包含编辑或删除报告的选项，以及复制报告链接的选项。

查看以前的报告版本

报告支持完整版本历史记录。要查看报告的以前版本，请在 应用程序 侧边栏展开报告卡片，或在新选项卡中查看报告时使用页面标题中的版本选择器。

选择报告版本将更新用于共享报告的链接，使您能够共享报告的特定历史版本，即使基础 R Markdown 已更改，该版本也不会更新。

在新选项卡中预览 R Markdown 报告。

报告的最新版本将默认选中，因此您的报告读者会自动接收到最新的更改。