セットアップ · macOS

Query Streams Agent をインストールします macOS

エージェントは、データと並行して動作し、接続処理を行う小型プログラムです。一度インストールすれば、あとはブラウザからすべての設定を行うことができます。

約10分 コーディングは不要です データはそのまま保持されます

Query Streams を使用すると、データベースやビジネス アプリケーションからライブ データを抽出して、Excel、Google スプレッドシート、レポート、または AI アシスタントに、データを最初にどこにもコピーすることなく取り込むことができます。そのためには、データにアクセスできる小さなヘルパー プログラムがどこかで実行されている必要があります。そのヘルパーは、 エージェント.

始める前に必要なもの

スリープ状態にならないMac

クエリ実行中は起動状態を維持する必要があるため、電源設定を確認しておくことをお勧めします。Apple Silicon（M1～M4）およびIntel Macでネイティブに動作します。

サインインキー

このエージェントを組織に紐付けるための、一度限りのコードです。ダウンロードページの「クエリストリーム」セクション、インストーラーのすぐ隣にあります。

データベースの詳細

サーバー名、データベース名、そしてデータベースを読み取るためのユーザー名とパスワード。もし他の人がデータベースを管理している場合は、この部分をその人に尋ねてください。

インストール手順は4つです

1. インストーラーをダウンロードして実行してください。

   サインインはこちら my.querystreams.com/ダウンロード そしてmacOSのダウンロードを選択してください。Apple Siliconネイティブ版とIntelネイティブ版があります。お使いのMacに合ったビルドをダウンロードし、ターミナルで数行のコマンドを実行してインストールしてください。管理者パスワードが必要になります。

   開く ターミナル （プレス ⌘ 空間 「ターミナル」と入力し、お使いのMacに合わせて以下の行を貼り付けてください。お使いのMacがどれかわからない場合は、Appleメニューをご覧ください。 このMacについて: チップ：アップルM… Apple Silicon を意味します。 プロセッサ：インテル… インテルを意味します。

   Apple Silicon（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

   Intel Mac

   cd ~/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 — それを サポートリクエスト そこから先は私たちがやります。インストールが完了したら、 querystreams-agent ダウンロードフォルダ内のフォルダ。

   エージェントはバックグラウンドサービスとして登録されます。これはつまり、Macが起動するたびに自動的に起動するということです。起動することを覚えておく必要はなく、ダウンロードするのはこの時だけです。 ここからは自動的に更新されます.

2. キーを使ってサインインしてください

   エージェントがインストールされたら、そのマシンでエージェントのページを開きます。

   先ほどインストールしたMacで

   http://localhost:1823

   サインインキーを貼り付けてください。バッジを確認してください。 左上隅: 一度読むと 「クエリ ストリームに接続しました」 緑色の点が表示されたら、ここでの作業は完了です。これはエージェントがアカウントに自己紹介している状態であり、このマシンで行うべき最後の作業です。

   ページ自体にも同じことが書いてあります。 「このエージェントはローカルで接続を実行します。日々の管理はクエリストリームポータルで行います。」 さあ、それを閉じてブラウザで作業を続けましょう。

3. 最初の接続を追加する — ブラウザから

   それではブラウザのクエリ ストリームに戻り、 データエージェント （それは以下です） データ トップメニューの[新しいエージェント]をクリックしてください。新しいエージェントがそこに表示されます。 コネクタを追加する そして、以下の質問に答えてください。データベースまたはアプリの種類を選択し、先に収集した詳細情報を入力してください。

   オープンデータエージェント

   接続を保存する前にテストできるので、後で問題に気づくのではなく、すぐに詳細が正しいかどうかを確認できます。Query Streamsは、一般的なデータベースに適した設定を提案し、すぐに実行できるサンプルクエリをいくつか追加します。

   保存すると、Query Streams はデータベース内をスキャンし、テーブル、列、それらの相互関係など、データベース内の情報を記録します。これがクエリビルダーで選択するリストを埋める情報となり、テーブル名を一つも指定しなくても Nova が「先月出荷した注文数」に答えることができる理由です。有効化も設定も不要で、データベースの変更に合わせてスケジュールに基づいて自動的に更新されます。

   それは形状を読み取るのであって、内容を読み取るのではない。 この手順は、行ではなく、テーブル名と列名に関するものです。大規模なデータベースでは、完了までに数分かかる場合があります。待つ必要はなく、コネクタで完了したことを確認できます。 データエージェント.

   あなたのパスワードは、そのマシンから決して外部に漏れることはありません。 接続を保存すると、その詳細は暗号化されたリンクを介してエージェントに送信され、認証情報は弊社ではなく、お客様自身のコンピューターに保存されます。

4. 最初のクエリを実行してください

   最も簡単な方法は、コネクタ設定の最後の画面で「クエリを開始」を押すことです。 開く クエリビルダー 新しい接続が既に選択されているので、何も探す必要はありません。また、上部メニューからいつでもアクセスできます。

   そこから、用意されているサンプルクエリのいずれかを実行するか、独自のクエリを作成するか、またはアシスタントであるNovaに平易な英語で質問してクエリを作成させることもできます。

   クエリを保存すると、あらゆる場所で再利用できるようになります。ExcelやGoogleスプレッドシート内で更新したり、スケジュールに追加したり、同僚と共有したり、AIアシスタントに渡したり、他のシステムが呼び出せるWebリンクに変換したりできます。

   クエリビルダーを開く ExcelとSheetsのアドインを入手してください

部品がどのように組み合わさるか

すべてブラウザから管理できます

エージェントがインストールされ、サインインしたら、 もうその機械に戻る必要はないはずです。 接続、含めるデータベース、データ更新頻度、エージェント自身の設定など、すべては以下から管理されます。 データエージェント お使いのブラウザで、どこにいても利用できます。

エージェントはクエリ ストリームと通信していますか？

エージェントページの左上にあるバッジは、「なぜこれが機能しないのか？」という疑問に対するほぼすべての答えです。常に4つのうちのいずれかが表示され、その文言から現在の状況が正確に分かります。探しているのはこれです。

常に最新の状態に保たれています

エージェントは一度インストールすれば完了です。再度ダウンロードを求められることもなく、「アップデートが利用可能です」という通知に気を取られることもありません。新しいバージョンがリリースされると、エージェントが自動的に、通常は数分以内にアップデートを行います。

アップデートを見逃さないように、3つの方法で確認できます。

新しい接続はいつから機能し始めますか？

ほとんどの場合、数秒以内です。正確な回答は担当エージェントによって異なります。

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 Linux