Qiskitのexecuteが使えない｜廃止の理由と直し方【2026年版】

Qiskitをバージョンアップしたら、以前は動いていたコードがImportError: cannot import name 'execute'やAerError: unknown instructionで止まった――この2つはどちらも同じところが原因です。execute()関数とは、回路の変換（トランスパイル）と実行をまとめて行っていた高レベルな関数のことで、Qiskit 1.0で廃止されています¹。現在はtranspile()で回路を実行先が理解できる基本ゲートに変換してからbackend.run()に渡す書き方に統一されました。この記事では、この2つのエラーを実際に手元で再現し、直し方をコードで確認します。

なぜexecute()が廃止されたのか

Qiskitは2024年にリリースされたバージョン1.0から、大きな仕様変更（破壊的変更）は年1回のメジャーリリースにまとめるという方針に切り替わりました。この1.0で、qiskit.execute()が削除されています¹。

execute(circuit, backend)は内部で「回路を実行先向けに変換する（transpile）」→「変換した回路を実行する（backend.run）」という2つの処理を順番に呼んでいただけの、いわば薄いラッパー関数でした。IBMの公式マイグレーションガイドも、この関数はtranspileとrunをまとめただけのものだったと説明し、廃止後は次のように書き換えるよう案内しています¹。

# 旧（Qiskit 1.0未満）
from qiskit import execute
result = execute(qc, backend, shots=1000).result()
 
# 新（Qiskit 1.0以降）
from qiskit import transpile
result = backend.run(transpile(qc, backend), shots=1000).result()

エラー①：ImportError: cannot import name 'execute'を直す

現在のQiskit（2.5系で確認）でfrom qiskit import executeを実行すると、次のエラーになります。

from qiskit import QuantumCircuit, execute

ImportError: cannot import name 'execute' from 'qiskit'

直し方は、importをtranspileに変えて、実行部分を2行に分けるだけです。

from qiskit import QuantumCircuit, transpile
from qiskit_aer import AerSimulator
 
qc = QuantumCircuit(2, 2)
qc.h(0)
qc.cx(0, 1)
qc.measure([0, 1], [0, 1])
 
backend = AerSimulator()
result = backend.run(transpile(qc, backend), shots=1000).result()
print(result.get_counts())

{'00': 492, '11': 508}

エラー②：AerError: unknown instructionが出るのはなぜか

もう1つよくあるのが、transpileを挟まずに回路をそのままrunに渡したときに出るAerErrorです。シミュレータは「自分が直接解釈できるゲートの一覧（basis gates）」しか実行できません。自作のUnitaryGateや、それを.control()で制御ゲート化したものは、この一覧に入っていない複合的な命令として扱われるため、トランスパイルで分解しないとシミュレータに渡せません。

次のコードは、1量子ビットの自作ユニタリゲートを制御ゲートにして、より大きな回路に組み込んだ例です（ショアのアルゴリズムの実装記事で使っている、位数発見用の制御ユニタリと同じ考え方です）。

import numpy as np
from qiskit import QuantumCircuit
from qiskit.circuit.library import UnitaryGate
from qiskit_aer import AerSimulator
 
perm = np.array([[0, 1], [1, 0]])          # 1量子ビットの置換(X相当)
gate = UnitaryGate(perm, label="custom_U").control()
 
qc = QuantumCircuit(2, 1)
qc.x(1)                       # 制御ビットを|1>にしておく
qc.append(gate, [0, 1])
qc.measure(1, 0)
 
backend = AerSimulator()
result = backend.run(qc, shots=100).result()   # transpileせずに直接run
print(result.get_counts())

AerError: 'unknown instruction: c-unitary'

transpile(qc, backend)を挟むだけで解消します。

result = backend.run(transpile(qc, backend), shots=100).result()
print(result.get_counts())

{'1': 100}

直すときの基本パターン

どちらのエラーも、直し方は同じ形に集約できます。

Qiskit Runtime入門で紹介したSamplerV2・EstimatorV2を使う場合も考え方は同じで、渡す回路は事前に対象バックエンドへtranspileしておく必要があります。クラウドの実機やシミュレータのノイズを再現したいときは、Qiskitのノイズモデルとトランスパイルで扱っているノイズ付きのtranspileも参考になります。

まとめ

• execute()はQiskit 1.0で廃止されている。代わりにtranspile(qc, backend)とbackend.run(...)を分けて書く
• AerError: unknown instructionは、シミュレータの基本ゲートにない命令（自作のユニタリゲートなど）をtranspileせずに渡したときに出る
• 直すときの基本形はbackend.run(transpile(qc, backend), shots=...)。この形にしておけば両方のエラーを避けられる
• Qiskit RuntimeのSamplerV2・EstimatorV2でも、回路は事前にtranspileしておく必要がある

よくある質問

もう少し詳しく（背景）

Qiskitは2024年2月リリースのバージョン1.0から、「大きな破壊的変更はメジャーバージョンの更新時にまとめて行う」という方針を取っています¹。execute()の廃止はこの1.0での変更の1つで、IBMの移行ガイドでは、プリミティブ（SamplerやEstimator）に対応したバックエンドではexecute()の代わりにSamplerプリミティブを使うことも案内されています¹。2026年3月時点の大学の講義資料でも、現在のQiskitではexecuteは標準の使い方ではなく、transpileとqiskit_aerのAerSimulatorを使うのが通常の流れだと説明されています²。

次に読むなら

• Qiskit入門｜量子回路をPythonで書いて動かしてみる — transpileやrunの基本をまだ触ったことがない方に
• Qiskitのノイズモデルとトランスパイル — トランスパイルが回路をどう変換しているか、もう一歩詳しく知りたい方に
• ショアのアルゴリズムをQiskitで実装 — 今回のunknown instructionエラーが実際に起きた、制御ユニタリゲートを使う実装例
• Qiskit Runtime入門｜プリミティブで量子回路を実行する — SamplerV2・EstimatorV2で同じ注意点がどう関わるか知りたい方に