设置 · macOS
在服务器上安装 Query Streams Agent macOS
代理程序是一个小型程序，它会驻留在您的数据旁边，负责连接。只需安装一次，然后通过浏览器设置其他所有选项即可。
Query Streams 允许您直接从数据库和业务应用程序中提取实时数据，并将其导入 Excel、Google Sheets、报表或 AI 助手，而无需事先将其复制到任何地方。为此，它需要一个小型辅助程序在某个可以访问您数据的地方运行。这个辅助程序就是…… 代理人.
开始之前你需要准备什么
一台保持唤醒状态的Mac
当用户运行查询时，它需要保持唤醒状态，因此值得检查一下电源设置。它可在 Apple Silicon（M1–M4）和 Intel Mac 上原生运行。
您的登录密钥
这是一个一次性代码，用于将此代理与您的组织关联。您可以在下载页面的“查询流”中找到它，就在安装程序旁边。
您的数据库详情
服务器名称、数据库名称以及可以读取该数据库的用户名和密码。如果您的数据库由其他人管理，则需要向他们索取这些信息。
它应该放在哪里？ 将代理程序安装在目前已能打开数据库的计算机上——通常是数据库服务器本身，或者同一办公网络上的任何一台电脑。如果您能从该计算机访问数据，代理程序也能访问。
分四步安装
-
下载并运行安装程序
登录 my.querystreams.com/下载 选择 macOS 下载——有 Apple Silicon 和 Intel 原生版本。下载与您的 Mac 匹配的版本，然后在终端中使用几行命令进行安装——您需要管理员密码。
打开 终端 （按 ⌘ 空间 输入“终端”），然后粘贴适用于您 Mac 的命令。不确定您使用的是哪款 Mac？请查看 Apple 菜单 › 关于这台Mac: 芯片：苹果公司… 指的是苹果芯片， 处理器：英特尔… 指的是英特尔。
苹果芯片（M1 – M4）cd ~/Downloads mkdir -p querystreams-agent tar -xzf querystreams-agent_*_osx-arm64.tar.gz -C querystreams-agent cd querystreams-agent sudo ./install.sh
英特尔 Maccd ~/Downloads mkdir -p querystreams-agent tar -xzf querystreams-agent_*_osx-x64.tar.gz -C querystreams-agent cd querystreams-agent sudo ./install.sh
这
*此处会显示版本号，所以您无需手动输入。如果您在该文件夹中下载了多个版本，请改为输入完整的文件名。sudo它会要求你输入 Mac 的密码。输入密码时不会显示任何内容——这是正常现象；按下 返回 当你完成的时候。如果您使用 Safari 下载，它可能已经将文件解压到以下载文件名命名的文件夹中（Safari 通常会这样做）。 下载完成后打开“安全”文件。 （已开启）。在这种情况下
焦油该行会提示找不到文件；请进入该文件夹并从那里运行安装程序：如果 Safari 已经解压了它cd ~/Downloads/querystreams-agent_*_osx-* sudo ./install.sh
然后检查它是否正在运行——你应该看到一行以“ com.querystreams.agent:
检查服务sudo launchctl list | grep querystreams
如果没有返回任何内容，日志位于：
/usr/local/querystreams/agent/logs/agent-stdout.log— 将其连接到 支持请求 接下来我们再继续。安装完成后，您可以删除它。查询流代理下载文件夹中。该代理程序会将自身注册为后台服务，简单来说就是它会在 Mac 启动时自动运行。您无需手动启动它，而且也只需在此时下载一次即可。 它从这里开始自动更新。.
-
使用您的密钥登录
代理程序安装完成后，在该计算机上打开其页面：
在您刚刚安装的Mac电脑上http://localhost:1823
粘贴您的登录密钥。查看徽章。 左上角一旦它读到 “已连接到查询流” 看到绿点就表示操作完成。这是代理程序向您的帐户进行自我介绍——也是您在这台机器上需要做的最后一件事。
页面本身也会告诉你同样的事情： “此代理在本地运行您的连接——日常管理在查询流门户中进行。” 这时你应该关闭它，继续在浏览器中操作。
-
通过浏览器添加您的第一个连接
现在返回浏览器中的“查询流”并打开 数据代理 （它在下面） 数据 在顶部菜单中）。您的新经纪人将列在那里。点击 添加连接器 然后按照问题进行操作：选择数据库或应用程序的类型，然后填写你之前收集的详细信息。
您可以在保存之前测试连接，这样就能立即知道详细信息是否正确，而无需稍后再发现。Query Streams 还会为常用数据库提供合理的设置建议，并添加少量现成的示例查询，方便您立即运行。
保存后，查询流会扫描您的数据库并记录其中的内容——包括表、列以及它们之间的关系。这些信息会填充到查询构建器中的查询列表中，也正是基于此，Nova 才能回答“我们上个月发货了多少订单？”这样的问题，而无需您指定任何表名。您无需手动启用或进行任何配置；它会按计划自动刷新，以便随着数据库的更改而保持更新。
它读取的是形状，而不是内容。 此步骤涉及表名和列名，而不是行。在大型数据库上，此步骤可能需要几分钟才能完成——您无需等待，完成后会在连接器中显示。 数据代理.
你的密码永远不会离开那台机器。 保存连接时，详细信息会通过加密链接传输到您的代理，凭据会存储在您自己的计算机上，而不是存储在我们这里。
-
运行你的第一个查询
最快捷的方法：在连接器设置的最后一个屏幕上按“开始查询”。 那打开 查询生成器 您已选择新的连接，无需再进行任何查找。您也可以随时从顶部菜单访问该连接。
然后，您可以运行一个现成的示例查询，编写自己的查询，或者直接用简单的英语向我们的助手 Nova 提问，让它为您编写查询。
保存查询后，它就可以在任何地方重复使用：在 Excel 或 Google Sheets 中刷新它、将其添加到计划中、与同事共享、将其交给 AI 助手，或将其转换为其他系统可以调用的网络链接。
各个部分如何契合
您可以通过浏览器管理所有操作。
代理安装并登录后， 你不需要再回到那台机器那里了。 所有的一切——连接、要包含的数据库、数据刷新频率、代理的所有自身设置——都由系统管理。 数据代理 无论您身在何处，都可以在您的浏览器中使用。
在浏览器中查询流
无论身在何处，你都能完成以下所有操作：
- 添加、编辑和删除连接
- 测试连接
- 选择要包含哪些数据库
- 设置数据刷新频率
- 所有代理设置
经纪人的个人页面
一份工作，你可能永远都不需要它：
- 检查代理为何无法访问查询流
如果您的代理在浏览器中显示为离线状态，但您找不到原因，请打开 localhost:1823 在那台机器上。左上角的徽章会立刻告诉你（看看这四个州是什么意思），而且它能够从它所处的位置看到网络——这是你的浏览器无法做到的。
代理人将完全放手不管。 它的设计理念是安装一次即可高枕无忧。所有操作都在向其迁移。 数据代理 在浏览器中，代理程序自身的页面只会保留一些信息，帮助您找出它无法访问查询流的原因。因此，如果指南或同事告诉您需要在代理程序机器上进行某些配置，请先检查浏览器。
如果您阅读过本指南的旧版本： 它说必须在代理商自己的页面上设置连接， 不 在浏览器中操作。现在情况已有所不同——浏览器是执行此操作的唯一途径。您之前以旧方式设置的任何内容仍然有效，您可以在数据代理中找到它们。
代理是否正在与查询流通信？
代理页面左上角的那个徽章几乎可以解答所有“为什么不起作用？”的问题。它总是显示以下四种情况之一，而文字说明则准确地告诉你目前的情况。这就是你要找的：
连接和重新连接的状态显示相同——一条移动的彩色条带，表示“正在处理”。稳定的绿色光表示已连接。暗淡的图标表示未连接。
那个小灯不是按钮。 它只显示状态——点击它没有任何反应。 连接, 重新连接 和 断开 页面下方“连接”面板上的控件被命名为按钮，这是有意为之：一个未标记的指示灯，点击后会悄悄地使您的代理离线，这是一个值得移除的陷阱。
一切正常。您的查询将会运行，您在浏览器中所做的任何更改都会在几秒钟内传达至此代理。无需任何操作。
机器启动或代理重启后，几秒钟内出现此现象属正常。请稍等片刻。
连接断开了，代理程序正在自行恢复连接——通常只是短暂的网络故障，不需要您提供任何帮助。
如果数据包在这里停留超过几分钟，说明网络上的某些东西阻塞了传输路径。这种情况值得我们关注。
在这种状态下，此代理上的所有功能都无法使用。 实际进行读取的是代理人，所以如果无法联系到代理人，就无法完成这项工作。
检查机器是否在线，然后按 重新连接 在“连接”面板中。如果连接仍然无法恢复，通常是防火墙或代理阻止了出站流量——请给我们留言，我们会帮您找出问题所在。
代理断开连接时，哪些功能会停止运行？ 所有需要接触其数据的事物：
- 针对其连接的查询将无法运行——无论是在查询构建器、Excel 或 Google Sheets 中、通过 REST API 还是通过 AI 助手。
- 该数据的计划刷新和自动化操作不会发生。
- 无法通过浏览器测试、浏览或刷新其连接。
- 在数据代理中，它显示为离线状态，您看到的数字是…… 最后已知 而不是活着的
不过，一切都不会丢失。浏览器离线期间您保存的更改会被保留，并在浏览器重新连接后立即生效——因此您可以继续进行设置，无需等待。
遇到网络连接问题需要联系我们吗？ 该页面上的“连接”面板列出了对我们帮助最大的四件事。请将它们复制到您的…… 支持 信息发送完毕后，我们通常可以跳过来回沟通：
- 机器
- 代理人正在使用哪台电脑？
- 组织
- 它关联到哪个账户
- 代理版本
- 它运行的是哪个版本？
- 自
- 它上次成功连接的时候
它会不断更新自身信息。
您只需安装一次代理程序。之后无需再次下载，也不会有“有更新可用”的提示需要您留意——当我们发布新版本时，您的代理程序会自动处理，通常只需片刻即可完成。
它提供了三种查询方式，因此不会错过任何更新：
我们发布更新后，会立即通过代理程序已建立的连接推送更新。更新完成后，代理程序会立即重启自身。
它会在重新上线几秒钟后询问是否错过了什么，然后进行补全。
它还会每天使用自己的对外连接进行检查——因此即使在严格封闭的网络中，它也能保持最新状态。
如何判断它是否跟得上进度。 代理页面上的“连接”面板显示 代理版本正常情况下，它会自动跟踪我们当前的版本。如果您发现它连续几天都远远落后于版本，则说明网络上的某些东西阻塞了更新路径——这值得注意。 给我们留言因为这不是特工能够靠三言两语就能摆脱的困境。
新连接何时开始生效？
几乎总是在几秒钟内。具体答案取决于您的代理：
代理程序正在运行且已更新至最新版本，因此能够立即检测到更改，无需重启。
您的更改已安全保存，并在机器恢复在线后立即生效。
这种情况很少见，因为代理程序会自动更新。查询流会在屏幕上显示这是否适用于您的代理程序。
Reading files on a network share
If a connector needs a file or folder on a network share, mount the share on this Mac before you add the connector. Mount it from Terminal with sudo, in a folder under /Volumes, so the Agent, which runs as a system background service, can see it. Share logins stored in the Portal are used by Windows Agents only. In the connector you can keep the \\server\share path, which the Agent maps onto the mount, or type the mount path directly. If the share isn’t mounted, 测试连接 says it is not mounted and shows the exact command to run.
How to mount a share for the Agent on a Mac
常见问题
我在哪里可以添加、编辑或删除连接？
在您的浏览器中， 数据代理 页面 — 使用 添加连接器更改通常会在几秒钟内到达您的代理。如果代理处于离线状态，更改会在它重新连接后立即生效。您无需操作代理计算机即可添加或更改连接。
我的数据会被复制到查询流吗？
不，您的数据库位置不变。当您运行查询时，代理程序会读取您的数据库，并仅返回查询请求的行。您的数据库密码保留在代理程序的服务器上。
我需要开放端口还是修改防火墙设置？
通常情况下不需要。代理程序会像网络浏览器一样向我们建立出站连接。它不需要接收来自互联网的传入流量。
我可以使用多个代理吗？
是的——很多组织会为每个站点或每个网络运行一个代理。它们都会显示在您的帐户中，因此对于编写查询的人来说，哪个代理持有哪个连接并不重要。
我需要不断更新吗？
不，也不需要点击任何东西。当我们发布新版本时，它会通过您代理已建立的连接推送，因此通常会在片刻内更新并自动重启。此外，它每天还会自动检查一次，以确保万无一失。您可以在下方查看当前版本。 代理版本 在其连接面板上。
如果我做到一半就卡住了怎么办？
给我们留言 支持 请在查询流中告诉我们您跳转到了哪里。如果这样更容易，请说明您正在查看哪个屏幕以及您期望看到什么——通常这些信息足以让我们找到问题所在。
Windows
LinuxSetup trouble?
- Agent shows Offline, or Test connection and Browse are greyed out? Check that the Agent is online → Is the Agent online?
English 
Spanish 
German 
French 
Portuguese 
Japanese 
Korean 
Chinese 
Italian 
Dutch 
Indonesian 
Polish