安装 · Windows
在服务器上安装 Query Streams Agent Windows
代理程序是一个小型程序，它会驻留在您的数据旁边，负责连接。只需安装一次，然后通过浏览器设置其他所有选项即可。
Query Streams 允许您直接从数据库和业务应用程序中提取实时数据，并将其导入 Excel、Google Sheets、报表或 AI 助手，而无需事先将其复制到任何地方。为此，它需要一个小型辅助程序在某个可以访问您数据的地方运行。这个辅助程序就是…… 代理人.
开始之前你需要准备什么
Windows PC 或服务器
当用户运行查询时，它必须保持开启状态。如果机器在夜间处于休眠状态，那么在唤醒之前它将无法使用。
您的登录密钥
这是一个一次性代码，用于将此代理与您的组织关联。您可以在下载页面的“查询流”中找到它，就在安装程序旁边。
您的数据库详情
服务器名称、数据库名称以及可以读取该数据库的用户名和密码。如果您的数据库由其他人管理，则需要向他们索取这些信息。
它应该放在哪里？ 将代理程序安装在目前已能打开数据库的计算机上——通常是数据库服务器本身，或者同一办公网络上的任何一台电脑。如果您能从该计算机访问数据，代理程序也能访问。
分四步安装
-
下载并运行安装程序
登录 my.querystreams.com/下载 选择Windows下载版本。运行该文件并接受提示。
该代理程序会以 Windows 服务的形式安装，也就是说，它会在计算机启动时自动运行。您无需手动启动它，而且您只需下载一次即可。 它从这里开始自动更新。.
-
使用您的密钥登录
代理程序安装完成后，在该计算机上打开其页面：
在你刚刚安装它的那台机器上http://localhost:1823
粘贴您的登录密钥。查看徽章。 左上角一旦它读到 “已连接到查询流” 看到绿点就表示操作完成。这是代理程序向您的帐户进行自我介绍——也是您在这台机器上需要做的最后一件事。
页面本身也会告诉你同样的事情： “此代理在本地运行您的连接——日常管理在查询流门户中进行。” 这时你应该关闭它，继续在浏览器中操作。
-
通过浏览器添加您的第一个连接
现在返回浏览器中的“查询流”并打开 数据代理 （它在下面） 数据 在顶部菜单中）。您的新经纪人将列在那里。点击 添加连接器 然后按照问题进行操作：选择数据库或应用程序的类型，然后填写你之前收集的详细信息。
您可以在保存之前测试连接，这样就能立即知道详细信息是否正确，而无需稍后再发现。Query Streams 还会为常用数据库提供合理的设置建议，并添加少量现成的示例查询，方便您立即运行。
保存后，查询流会扫描您的数据库并记录其中的内容——包括表、列以及它们之间的关系。这些信息会填充到查询构建器中的查询列表中，也正是基于此，Nova 才能回答“我们上个月发货了多少订单？”这样的问题，而无需您指定任何表名。您无需手动启用或进行任何配置；它会按计划自动刷新，以便随着数据库的更改而保持更新。
它读取的是形状，而不是内容。 此步骤涉及表名和列名，而不是行。在大型数据库上，此步骤可能需要几分钟才能完成——您无需等待，完成后会在连接器中显示。 数据代理.
你的密码永远不会离开那台机器。 保存连接时，详细信息会通过加密链接传输到您的代理，凭据会存储在您自己的计算机上，而不是存储在我们这里。
-
运行你的第一个查询
最快捷的方法：在连接器设置的最后一个屏幕上按“开始查询”。 那打开 查询生成器 您已选择新的连接，无需再进行任何查找。您也可以随时从顶部菜单访问该连接。
然后，您可以运行一个现成的示例查询，编写自己的查询，或者直接用简单的英语向我们的助手 Nova 提问，让它为您编写查询。
保存查询后，它就可以在任何地方重复使用：在 Excel 或 Google Sheets 中刷新它、将其添加到计划中、与同事共享、将其交给 AI 助手，或将其转换为其他系统可以调用的网络链接。
各个部分如何契合
您可以通过浏览器管理所有操作。
代理安装并登录后， 你不需要再回到那台机器那里了。 所有的一切——连接、要包含的数据库、数据刷新频率、代理的所有自身设置——都由系统管理。 数据代理 无论您身在何处，都可以在您的浏览器中使用。
在浏览器中查询流
无论身在何处，你都能完成以下所有操作：
- 添加、编辑和删除连接
- 测试连接
- 选择要包含哪些数据库
- 设置数据刷新频率
- 所有代理设置
经纪人的个人页面
一份工作，你可能永远都不需要它：
- 检查代理为何无法访问查询流
如果您的代理在浏览器中显示为离线状态，但您找不到原因，请打开 localhost:1823 在那台机器上。左上角的徽章会立刻告诉你（看看这四个州是什么意思），而且它能够从它所处的位置看到网络——这是你的浏览器无法做到的。
代理人将完全放手不管。 它的设计理念是安装一次即可高枕无忧。所有操作都在向其迁移。 数据代理 在浏览器中，代理程序自身的页面只会保留一些信息，帮助您找出它无法访问查询流的原因。因此，如果指南或同事告诉您需要在代理程序机器上进行某些配置，请先检查浏览器。
如果您阅读过本指南的旧版本： 它说必须在代理商自己的页面上设置连接， 不 在浏览器中操作。现在情况已有所不同——浏览器是执行此操作的唯一途径。您之前以旧方式设置的任何内容仍然有效，您可以在数据代理中找到它们。
代理是否正在与查询流通信？
代理页面左上角的那个徽章几乎可以解答所有“为什么不起作用？”的问题。它总是显示以下四种情况之一，而文字说明则准确地告诉你目前的情况。这就是你要找的：
连接和重新连接的状态显示相同——一条移动的彩色条带，表示“正在处理”。稳定的绿色光表示已连接。暗淡的图标表示未连接。
那个小灯不是按钮。 它只显示状态——点击它没有任何反应。 连接, 重新连接 和 断开 页面下方“连接”面板上的控件被命名为按钮，这是有意为之：一个未标记的指示灯，点击后会悄悄地使您的代理离线，这是一个值得移除的陷阱。
一切正常。您的查询将会运行，您在浏览器中所做的任何更改都会在几秒钟内传达至此代理。无需任何操作。
机器启动或代理重启后，几秒钟内出现此现象属正常。请稍等片刻。
连接断开了，代理程序正在自行恢复连接——通常只是短暂的网络故障，不需要您提供任何帮助。
如果数据包在这里停留超过几分钟，说明网络上的某些东西阻塞了传输路径。这种情况值得我们关注。
在这种状态下，此代理上的所有功能都无法使用。 实际进行读取的是代理人，所以如果无法联系到代理人，就无法完成这项工作。
检查机器是否在线，然后按 重新连接 在“连接”面板中。如果连接仍然无法恢复，通常是防火墙或代理阻止了出站流量——请给我们留言，我们会帮您找出问题所在。
代理断开连接时，哪些功能会停止运行？ 所有需要接触其数据的事物：
- 针对其连接的查询将无法运行——无论是在查询构建器、Excel 或 Google Sheets 中、通过 REST API 还是通过 AI 助手。
- 该数据的计划刷新和自动化操作不会发生。
- 无法通过浏览器测试、浏览或刷新其连接。
- 在数据代理中，它显示为离线状态，您看到的数字是…… 最后已知 而不是活着的
不过，一切都不会丢失。浏览器离线期间您保存的更改会被保留，并在浏览器重新连接后立即生效——因此您可以继续进行设置，无需等待。
遇到网络连接问题需要联系我们吗？ 该页面上的“连接”面板列出了对我们帮助最大的四件事。请将它们复制到您的…… 支持 信息发送完毕后，我们通常可以跳过来回沟通：
- 机器
- 代理人正在使用哪台电脑？
- 组织
- 它关联到哪个账户
- 代理版本
- 它运行的是哪个版本？
- 自
- 它上次成功连接的时候
它会不断更新自身信息。
您只需安装一次代理程序。之后无需再次下载，也不会有“有更新可用”的提示需要您留意——当我们发布新版本时，您的代理程序会自动处理，通常只需片刻即可完成。
它提供了三种查询方式，因此不会错过任何更新：
我们发布更新后，会立即通过代理程序已建立的连接推送更新。更新完成后，代理程序会立即重启自身。
它会在重新上线几秒钟后询问是否错过了什么，然后进行补全。
它还会每天使用自己的对外连接进行检查——因此即使在严格封闭的网络中，它也能保持最新状态。
如何判断它是否跟得上进度。 代理页面上的“连接”面板显示 代理版本正常情况下，它会自动跟踪我们当前的版本。如果您发现它连续几天都远远落后于版本，则说明网络上的某些东西阻塞了更新路径——这值得注意。 给我们留言因为这不是特工能够靠三言两语就能摆脱的困境。
新连接何时开始生效？
几乎总是在几秒钟内。具体答案取决于您的代理：
代理程序正在运行且已更新至最新版本，因此能够立即检测到更改，无需重启。
您的更改已安全保存，并在机器恢复在线后立即生效。
这种情况很少见，因为代理程序会自动更新。查询流会在屏幕上显示这是否适用于您的代理程序。
常见问题
我在哪里可以添加、编辑或删除连接？
在您的浏览器中， 数据代理 页面 — 使用 添加连接器更改通常会在几秒钟内到达您的代理。如果代理处于离线状态，更改会在它重新连接后立即生效。您无需操作代理计算机即可添加或更改连接。
我的数据会被复制到查询流吗？
不，您的数据库位置不变。当您运行查询时，代理程序会读取您的数据库，并仅返回查询请求的行。您的数据库密码保留在代理程序的服务器上。
我需要开放端口还是修改防火墙设置？
通常情况下不需要。代理程序会像网络浏览器一样向我们建立出站连接。它不需要接收来自互联网的传入流量。
我可以使用多个代理吗？
是的——很多组织会为每个站点或每个网络运行一个代理。它们都会显示在您的帐户中，因此对于编写查询的人来说，哪个代理持有哪个连接并不重要。
我需要不断更新吗？
不，也不需要点击任何东西。当我们发布新版本时，它会通过您代理已建立的连接推送，因此通常会在片刻内更新并自动重启。此外，它每天还会自动检查一次，以确保万无一失。您可以在下方查看当前版本。 代理版本 在其连接面板上。
如果我做到一半就卡住了怎么办？
给我们留言 支持 请在查询流中告诉我们您跳转到了哪里。如果这样更容易，请说明您正在查看哪个屏幕以及您期望看到什么——通常这些信息足以让我们找到问题所在。
Linux
macOSSetup 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