> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# スタンドアロンスクリプト

> アプリに対してスタンドアロンスクリプトを実行する

`base44 exec` コマンドを使用して、Base44 アプリと対話するスタンドアロンスクリプトを実行できます。

スタンドアロンスクリプトは:

* セットアップやトークン管理は不要です。事前認証された SDK クライアントがグローバルの `base44` 変数として利用できます。
* [Deno](https://docs.deno.com/runtime/) を使用してローカルで実行され、現在のプロジェクトディレクトリにリンクされたデプロイ済みアプリに対して実行されます。
* SDK を介してアプリのエンティティ、関数、インテグレーションへの完全なアクセスを持ちます。
* サービスロールアクセスではなく、ユーザーの権限で実行されます。

## 前提条件

exec でスクリプトを実行するには、[Deno](https://docs.deno.com/runtime/getting_started/installation/) をインストールする必要があります。

## ユースケース

`exec` コマンドは、スタンドアロンスクリプトから完全な SDK への直接アクセスを提供します。一般的なユースケースには以下のものがあります:

* **データマイグレーション:** エンティティレコードを一括で再形成、バックフィル、変換します。
* **シードスクリプト:** 開発またはステージング用のサンプルデータをアプリに投入します。
* **アドホッククエリ:** ターミナルからアプリのデータを素早く検査またはデバッグします。
* **AI および LLM タスク:** データの要約、コンテンツ生成、レコードの強化など、ワンオフの AI 操作を実行します。
* **関数テスト:** 実際のデータでバックエンド関数を呼び出して、アプリ外でテストします。
* **自動化:** CI パイプラインまたはスケジュールされたジョブでスクリプトを実行して、メンテナンスタスクを実行します。

## はじめる

開始するには、スクリプトファイルを作成し、それを exec にパイプします。

<Steps>
  <Step title="スクリプトを書く">
    `base44` グローバル変数を使用するスクリプトファイルを作成します。インポートやセットアップは不要です。例:

    ```typescript theme={null}
    // list-tasks.ts
    const tasks = await base44.entities.Task.list();
    console.log(`Found ${tasks.length} tasks:`);
    for (const task of tasks) {
      console.log(`  - ${task.title} (${task.status})`);
    }
    ```
  </Step>

  <Step title="実行する">
    プロジェクトディレクトリからスクリプトを実行します:

    ```bash theme={null}
    cat ./list-tasks.ts | base44 exec
    ```

    CLI は現在のユーザーとして認証し、Deno プロセスを開始し、`base44` SDK クライアントが使用準備完了の状態でスクリプトを実行します。

    <Tip>
      クイックなワンライナーには、インラインコードを直接パイプしてください:

      ```bash theme={null}
      echo "console.log(await base44.entities.Task.list())" | base44 exec
      ```
    </Tip>
  </Step>
</Steps>

## 関連項目

* [`exec`](/developers/references/cli/commands/exec): 完全なコマンドリファレンス
* [Backend functions](/developers/backend/resources/backend-functions/overview): Base44 のインフラストラクチャ上で実行されるサーバーレス関数を作成
* [JavaScript SDK](/developers/references/sdk/getting-started/overview): エンティティ、認証、関数、インテグレーション用の SDK リファレンス

<Note>このページは AI を使用して翻訳されました。最も正確で最新の情報については、[英語版](/) を参照してください。 </Note>