StartExternalSession["sys"]
外部評価器 sys を使って外部セッションを開始し,外部セッションオブジェクトを返す.
StartExternalSession[assoc]
assoc で指定された外部評価器を開始する.
StartExternalSession[obj]
ExternalEvaluatorObjectで指定された外部評価器を開始する.
StartExternalSession[{"sys",opts}]
外部評価器にオプション opts を使う.
StartExternalSession[systype]
外部評価器からの出力を指定のタイプに変換するように指定する.
StartExternalSession[DatabaseReference[ref]]
ref で指定されたデータベースを使ってデータベースセッションを開始する.
StartExternalSession["sys"]
外部評価器 sys を使って外部セッションを開始し,外部セッションオブジェクトを返す.
StartExternalSession[assoc]
assoc で指定された外部評価器を開始する.
StartExternalSession[obj]
ExternalEvaluatorObjectで指定された外部評価器を開始する.
StartExternalSession[{"sys",opts}]
外部評価器にオプション opts を使う.
StartExternalSession[systype]
外部評価器からの出力を指定のタイプに変換するように指定する.
StartExternalSession[DatabaseReference[ref]]
ref で指定されたデータベースを使ってデータベースセッションを開始する.
詳細
- StartExternalSessionは,外部評価器セッションの実装に使うことができる外部プロセスを開始する.このセッションには,ExternalEvaluateにリクエストされた複数の評価が含まれる.
- StartExternalSession[assoc]の連想の要素には以下が含まれる.
-
"System" 開始する外部システムまたは言語 "Evaluator" コードの評価に使う評価器 "Name" 評価器の登録名 "ID" 一意的な識別子 "ReturnType" 返すオブジェクトのタイプ("String","Expression"等) "Prolog" このセッションでコマンドが評価される前に実行するコード "Epilog" このセッションでコマンドが評価された後に実行するコード "SessionProlog" セッションの前に実行するコード "SessionEpilog" セッションの後で実行するコード - 必要な唯一のキーは"System"である.これ以外のキーはすべて任意である.
- 以下は,StartExternalSession[sys]の sys の可能な選択肢である.
-
"Python" Python "NodeJS" Node.jsを介して実行されるJavaScript "Julia" Julia "Ruby" Ruby "R" R "Shell" Bash, Sh, Zsh, ... "Jupyter" Jupyterカーネル "SQL" SQLデータベース "SQL-JDBC" JDBCを使ったSQLデータベース - StartExternalSession[sys"type",…]における,あるいは"ReturnType"についての"type"の可能な設定は評価システムに依存するが,代表的なものには以下がある.
-
"Expression" Wolfram言語式に変換しようとする "String" 外部評価器による生の文字列出力を与える - StartExternalSession[{sys,"Evaluator"evaluator},…]の evaluator の設定は sys に依存する.以下は可能な設定である.
-
"path" 言語実行可能ファイルへのパス DatabaseReference[…] SQLデータベース接続 SQLConnection[…] SQL-JDBCデータベース接続 - 一般に,StartExternalSessionは設定"ReturnType""Expression"を使う.
- StartExternalSession[{"sys",opts}]はStartExternalSession[<|"System""sys",opts|>]に等しい.
- StartExternalSession[{sys,"ID""id",…}]は,指定された"id"を持つすでに実行中のセッションを返すか,一意的な"id"を持つ新たなセッションを開始するかする.
- ExternalEvaluatorsは,使用可能な評価器システムのリストを与える.
- ExternalSessionsは,アクティブな外部セッションのリストを与える.
- DeleteObject[ExternalSessionObject[…]]はStartExternalSessionが開始した外部セッションを強制終了して削除する.
例題
すべて開く すべて閉じる例 (2)
Pythonセッションを開始し,使用可能な任意のインストレーションを自動的に検知する:
session = StartExternalSession["Python"]ExternalEvaluate[session, "1+1"]DeleteObjectでセッションを終了する:
DeleteObject[session]プロビジョニング済みの環境で新たなPythonのセッションを開始する:
session = StartExternalSession[
{
"Python",
"Evaluator" -> <|
"Dependencies" -> {"emoji"},
"EnvironmentName" -> "myenv",
"PythonRuntime" -> "3.11"
|>
}
]ExternalEvaluate[
session,
"import emoji; emoji.emojize('Emojis are :thumbs_up:')"
]スコープ (16)
基本的な用法 (2)
{StartExternalSession["Python"], StartExternalSession["NodeJS"], StartExternalSession["Julia"]}DeleteObject[%]/usr/bin/python3の実行ファイルを使って外部Pythonセッションを開始する:
session = StartExternalSession[<|"System" -> "Python", "Evaluator" -> "/usr/bin/python3"|>]ExternalEvaluateへの複数の呼出しにこのセッションを使う:
ExternalEvaluate[session, "x='hello world'"]ExternalEvaluate[session, "x"]DeleteObjectでセッションを終了する:
DeleteObject[session]セッションオプション (14)
"ReturnType" (4)
ほとんどのシステムのデフォルトの戻り型は"Expression"である:
session = StartExternalSession["Python"]value = ExternalEvaluate[session, "2+2"]IntegerQ[value]DeleteObject[session]"Expression"の戻り型については,数,文字列,リスト,連想は自動的にインポートされる:
session = StartExternalSession["Python"]result = ExternalEvaluate[session, "[2, 3, 'foobar', (1, 1)]"]Map[Head, result]DeleteObject[session]"String"の戻り型は結果の文字列を外部言語で返す:
session = StartExternalSession["Python" -> "String"]result = ExternalEvaluate[session, "[1, 2, u'א']"]StringQ[result]DeleteObject[session]データベースを使用する際のデフォルトの戻り型は"Dataset"である:
db = DatabaseReference[FindFile["ExampleData/ecommerce-database.sqlite"]];session = StartExternalSession[db]ExternalEvaluate[session, "select officeCode as pk, phone from offices"]"ReturnType"を使ってデータを別の形式で返すことができる:
sessionRows = StartExternalSession[{db, "ReturnType" -> "Rows"}];ExternalEvaluate[sessionRows, "select officeCode as pk, phone from offices"]sessionNamedRows = StartExternalSession[{db, "ReturnType" -> "NamedRows"}];ExternalEvaluate[sessionNamedRows, "select officeCode as pk, phone from offices"]sessionColumns = StartExternalSession[{db, "ReturnType" -> "Columns"}];ExternalEvaluate[sessionColumns, "select officeCode as pk, phone from offices"]sessionNamedColumns = StartExternalSession[{db, "ReturnType" -> "NamedColumns"}];ExternalEvaluate[sessionNamedColumns, "select officeCode as pk, phone from offices"]DeleteObject /@ {session, sessionRows, sessionNamedRows, sessionColumns, sessionNamedColumns};"Evaluator" (3)
session = StartExternalSession[
{"Python", "Evaluator" -> "/opt/homebrew/bin/python3"}]ExternalEvaluate[session, "import sys; sys.executable"]DeleteObject[session]Associationを使ってPythonプロビジョニングされた環境が開始できる:
session = StartExternalSession[
{
"Python",
"Evaluator" -> <|
"Dependencies" -> {"emoji"},
"PythonRuntime" -> "3.11",
"EnvironmentName" -> "my-emoji-env"
|>
}
]ExternalEvaluate[session,
"import emoji; import sys; [emoji.emojize('Emojis are :thumbs_up:'), sys.version, sys.executable]"]{"Emojis are 👍", "3.11.4 (main, Jul 5 2023, 08:41:25) [Clang 14.0.6 ]", "/Users/WolframUser/Library/Mathematica/ApplicationData/ExternalEvaluate/Python/Venv/my-emoji-env/bin/python"}DeleteObject[session]"SQL"評価器でFileを使う際のターゲットはSQLiteファイルのパスかDatabaseReference指定でよい:
s1 = StartExternalSession[{"SQL", "Evaluator" -> FindFile["ExampleData/ecommerce-database.sqlite"]}];ExternalEvaluate[s1, "select officeCode, city from offices"]s2 = StartExternalSession[{"SQL", "Evaluator" ->
DatabaseReference[URL["postgres://localhost/template1"]]}];ExternalEvaluate[{"SQL", "Evaluator" -> s2 }, "SELECT NOW() as now, NOW()::date as date, interval '1 day' as interval, '1.23'::decimal as decimal"]DeleteObject /@ {s1, s2}"Name" (1)
RegisterExternalEvaluator[
"Python",
<|"Dependencies" -> {"numpy"}, "EnvironmentName" -> "my-numpy-env"|>,
"numpy-env"
]登録された評価器をその名前で参照することで使ってセッションを開始する:
session = StartExternalSession[{"Python", "Name" -> "numpy-env"}]ExternalEvaluate[session, "import numpy; numpy.arange(12)"]DeleteObject[session]"ID" (1)
session = StartExternalSession[{"Python", "ID" -> "my-unique-id"}]この操作は冪等で,同じ"ID"のセッションを開始すると実行中の同じセッションが返される:
StartExternalSession[{"Python", "ID" -> "my-unique-id"}]StartExternalSessionを2回実行しても実行中のセッションは1つであることが確かめられる:
ExternalSessions[]DeleteObject[session]"SessionProlog" (2)
"SessionProlog"を使ってセッションの開始時に副作用を実行する:
session = StartExternalSession[{"Python", "SessionProlog" -> "print('session started')"}];ExternalEvaluate[session, "print('evaluating code'); 2+2"]DeleteObject[session]外部セッションを開始し,セッションの開始時にライブラリをインポートする:
session = StartExternalSession[<|"System" -> "Python", "SessionProlog" -> "import math"|>]ExternalEvaluate[session, "math.factorial(4)"]DeleteObject[session]"SessionEpilog" (1)
"Prolog" (1)
"Epilog" (1)
session = StartExternalSession[{"Python", "SessionProlog" -> "n=0", "Prolog" -> "print('n was', n)", "Epilog" -> "print('n is', n)"}];ExternalEvaluate[session, {"n += 3", "n += 3"}]DeleteObject[session]特性と関係 (5)
sessions = Table[StartExternalSession["Python"], 2]ExternalEvaluate[#, "import os; os.getpid()"]& /@ sessionsDeleteObject[sessions]言語しか指定されていない場合は,可能であれば評価器が自動的にプロビジョニングされる:
session = StartExternalSession["Python"];session["Evaluator"]評価器は$UserBaseDirectoryに格納される:
ExternalEvaluate[session, "import sys; [sys.version, sys.executable]"]DeleteObject[session]ExternalEvaluatorsを使ってシステムで使用可能なすべての評価器を求める:
evaluators = ExternalEvaluators["Shell"]StartExternalSessionを使ってそこからセッションを開始する:
session = StartExternalSession[First @ evaluators]ExternalEvaluate[session, "ping -c 1 wolfram.com"]DeleteObject[session];db = DatabaseReference[FindFile["ExampleData/ecommerce-database.sqlite"]]session = StartExternalSession[db]ExternalEvaluate[session, "SELECT * from offices limit 5"]DeleteObject[session];外部言語セルは暗黙のうちにStartExternalSessionを呼び出す:
ExternalSessions[]ExternalSessions[]デフォルトで,与えられたシステムのすべてのセルがそのセッションを使う:
続く評価で新たなセッションが開始されるように,セッションを終了する:
DeleteObject[Last[%%]]関連するガイド
テキスト
Wolfram Research (2017), StartExternalSession, Wolfram言語関数, https://reference.wolfram.com/language/ref/StartExternalSession.html (2026年に更新).
CMS
Wolfram Language. 2017. "StartExternalSession." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2026. https://reference.wolfram.com/language/ref/StartExternalSession.html.
APA
Wolfram Language. (2017). StartExternalSession. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/StartExternalSession.html
BibTeX
@misc{reference.wolfram_2026_startexternalsession, author="Wolfram Research", title="{StartExternalSession}", year="2026", howpublished="\url{https://reference.wolfram.com/language/ref/StartExternalSession.html}", note=[Accessed: 15-November-2026]}
BibLaTeX
@online{reference.wolfram_2026_startexternalsession, organization={Wolfram Research}, title={StartExternalSession}, year={2026}, url={https://reference.wolfram.com/language/ref/StartExternalSession.html}, note=[Accessed: 15-November-2026]}