{ "cells": [ { "cell_type": "markdown", "id": "6ec2a7ce-6d72-401c-aecd-59f2f519153a", "metadata": {}, "source": [ "---\n", "title: \"Esegui il tuo primo carico di lavoro di Qiskit Serverless in remoto\"\n", "description: \"Come elencare i programmi disponibili in Serverless, passare gli input a questi programmi, eseguirli in remoto, controllarne lo stato e recuperare risultati e log.\"\n", "---\n", "\n", "\n", "\n", "# Esegui il tuo primo carico di lavoro di Qiskit Serverless in remoto\n", "\n" ] }, { "cell_type": "markdown", "id": "1ffb4bbc-6702-4424-bc38-226eb3194a07", "metadata": { "tags": [ "version-info" ] }, "source": [ "\n", " \n", " Il codice di questa pagina è stato sviluppato in base ai seguenti requisiti.\n", " Si consiglia di utilizzare queste versioni o versioni più recenti.\n", "\n", " ```\n", " qiskit[all]~=1.4.0\n", " qiskit-ibm-runtime~=0.36.1\n", " qiskit-ibm-catalog~=0.4\n", " ```\n", " \n", "\n", "\n" ] }, { "cell_type": "markdown", "id": "33bc7389-22b7-4ddd-ae7d-1c4fd603d793", "metadata": {}, "source": [ "\n", " **Qiskit Serverless sta subendo un aggiornamento e le sue caratteristiche stanno cambiando rapidamente.** Durante questa fase di sviluppo, è possibile trovare le note di rilascio e la documentazione più recente alla pagina [Qiskit ServerlessGitHub](https://qiskit.github.io/qiskit-serverless/index.html).\n", "\n", "\n", "Questa sezione spiega come utilizzare `qiskit-ibm-catalog` per elencare i programmi disponibili in Qiskit Serverless, passare gli input a questi programmi, eseguirli in remoto, controllarne lo stato e recuperare i risultati e i log.\n", "\n", "Assicurati di aver seguito la procedura descritta nella sezione \" [Scrivi il tuo primo programma in Qiskit Serverless ](/docs/guides/serverless-first-program)\" prima di iniziare.\n", "\n" ] }, { "cell_type": "markdown", "id": "ec693d85-baaf-487e-aaff-3867512a4790", "metadata": {}, "source": [ "\n", "\n", "## Elenco dei programmi disponibili\n", "\n", "È possibile utilizzare `QiskitServerless.list()` per visualizzare l'elenco dei programmi disponibili da eseguire con Qiskit Serverless. Ciò include il file caricato in precedenza [`transpile_remote_serverless`](/docs/guides/serverless-first-program).\n", "\n" ] }, { "cell_type": "code", "execution_count": 1, "id": "4eaad0dc-9b42-48fa-ad08-4e0f9c4d90bc", "metadata": {}, "outputs": [ { "data": { "text/plain": [ "QiskitFunction(transpile_remote_serverless)" ] }, "execution_count": 1, "metadata": {}, "output_type": "execute_result" } ], "source": [ "from qiskit_ibm_catalog import QiskitServerless\n", "\n", "serverless = QiskitServerless()\n", "next(\n", " program\n", " for program in serverless.list()\n", " if program.title == \"transpile_remote_serverless\"\n", ")" ] }, { "cell_type": "markdown", "id": "e1a5d0f7-e4d9-4289-ac87-ca25e76f968d", "metadata": {}, "source": [ "\n", "\n", "## Esegui un programma caricato e passa gli input\n", "\n", "Per prima cosa, impostate gli ingressi. Il programma ha tre ingressi: `circuits`, `backend`, e `optimization_level`. È possibile utilizzare `random_circuit` per creare 30 circuiti casuali:\n", "\n" ] }, { "cell_type": "code", "execution_count": 2, "id": "46108a95-11f8-4ecf-83bb-131c3e7ea4c2", "metadata": {}, "outputs": [ { "data": { "text/plain": [ "\"Output" ] }, "execution_count": 2, "metadata": {}, "output_type": "execute_result" } ], "source": [ "from qiskit.circuit.random import random_circuit\n", "\n", "qc_random = [(random_circuit(4, 4, measure=True, seed=i)) for i in range(10)]\n", "qc_random[0].draw(output=\"mpl\", idle_wires=False)" ] }, { "cell_type": "markdown", "id": "61c17ded-b832-4db1-ba9a-60772362daea", "metadata": {}, "source": [ "Quindi, utilizzare `QiskitRuntimeService` e `least_busy` per selezionare un `backend`:\n", "\n" ] }, { "cell_type": "code", "execution_count": null, "id": "ebefb5ac-c8a8-4350-b16f-0677f0e412e5", "metadata": {}, "outputs": [], "source": [ "from qiskit_ibm_runtime import QiskitRuntimeService\n", "\n", "service = QiskitRuntimeService()\n", "backend = service.least_busy(operational=True, simulator=False)\n", "print(backend.name)" ] }, { "cell_type": "markdown", "id": "6a6ba35b-b98b-41b1-8dd4-c7cf2fc8b637", "metadata": {}, "source": [ "Impostare il livello di ottimizzazione:\n", "\n" ] }, { "cell_type": "code", "execution_count": 4, "id": "cab2773b-f72a-49fe-a274-169a10e89c5e", "metadata": {}, "outputs": [], "source": [ "optimization_level = 3" ] }, { "cell_type": "markdown", "id": "f522b54f-93e5-45e9-9dc7-a2287eb4c707", "metadata": {}, "source": [ "Selezionare il programma con `serverless.load('PROGRAM_NAME')`:\n", "\n" ] }, { "cell_type": "code", "execution_count": 5, "id": "e9b7e7c1-07b1-4777-bb08-1522433901c6", "metadata": {}, "outputs": [], "source": [ "transpile_remote_serverless = serverless.load(\"transpile_remote_serverless\")" ] }, { "cell_type": "markdown", "id": "8e256a2a-6b14-4194-8fee-df986c7ebc6c", "metadata": {}, "source": [ "Quindi, passate i vostri input ed eseguiteli in modo pitonico come segue:\n", "\n" ] }, { "cell_type": "code", "execution_count": 6, "id": "85b1aace-e7d7-4e2e-bb77-44fb514d0236", "metadata": {}, "outputs": [], "source": [ "job = transpile_remote_serverless.run(\n", " circuits=qc_random,\n", " backend=backend.name,\n", " optimization_level=optimization_level,\n", ")" ] }, { "cell_type": "code", "execution_count": 7, "id": "2e8b4ec2-b7e3-4218-8742-b67f2a1d82e0", "metadata": {}, "outputs": [ { "data": { "text/plain": [ "'118256c5-bbb0-4ea8-9e9f-51aac2220aef'" ] }, "execution_count": 7, "metadata": {}, "output_type": "execute_result" } ], "source": [ "job.job_id" ] }, { "cell_type": "markdown", "id": "87dbb375-cd24-4d0f-a2fc-c653db8345e3", "metadata": {}, "source": [ "\n", "\n", "\n", "\n", "## Controlla lo stato del lavoro\n", "\n", "Con il vostro Qiskit Serverless `job_id`, potete controllare lo stato dei lavori in esecuzione. Questo include i seguenti stati:\n", "\n", "* **`QUEUED`**: Il programma remoto è nella coda di Qiskit Serverless. La priorità della coda è attualmente basata sulla quantità di utilizzo di Qiskit Serverless\n", "* **`INITIALIZING`**: Il programma remoto si sta avviando; questo include la configurazione dell'ambiente remoto e l'installazione delle dipendenze\n", "* **`RUNNING`**: Il programma è in esecuzione. A questo punto, se nel programma sono presenti le uscite di `print()` , è possibile recuperare i registri usando `job.logs()`\n", "* **`DONE`**: Il programma è completo ed è possibile richiamare i dati memorizzati in `save_result()` con `job.results()`\n", "\n", "È inoltre possibile impostare stati di lavoro più dettagliati in [Manage Qiskit Serverless compute and data resources](/docs/guides/serverless-manage-resources).\n", "\n" ] }, { "cell_type": "code", "execution_count": 8, "id": "f4877d45-c350-4855-b1ca-868a6ad8cfa4", "metadata": {}, "outputs": [ { "data": { "text/plain": [ "'QUEUED'" ] }, "execution_count": 8, "metadata": {}, "output_type": "execute_result" } ], "source": [ "job.status()" ] }, { "cell_type": "markdown", "id": "3fa9c01e-18a4-482c-bad6-69dee5acece4", "metadata": {}, "source": [ "\n", " Attualmente, la tabella dei carichi di lavoro di IBM Quantum riporta solo i carichi di lavoro del servizio di elaborazione IBM Quantum. Utilizza `job.status()` per visualizzare lo stato attuale del tuo carico di lavoro Qiskit Serverless.\n", "\n", "\n", "Avete eseguito con successo il vostro primo programma Qiskit Serverless!\n", "\n" ] }, { "cell_type": "markdown", "id": "65566f2c-8d5b-4493-819b-4389155c3d69", "metadata": {}, "source": [ "\n", "\n", "## Recupera i registri e i risultati\n", "\n", "Come già detto, una volta che un programma è `RUNNING`, si può usare `job.logs()` per recuperare i registri creati dalle uscite di `print()` :\n", "\n" ] }, { "cell_type": "code", "execution_count": 10, "id": "cbf12a1b-bfff-4eb2-82f1-298de1e9c114", "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "No logs yet.\n" ] } ], "source": [ "logs = job.logs()\n", "print(logs)" ] }, { "cell_type": "markdown", "id": "bff87452-bf98-4c7a-85c8-d280d89a7970", "metadata": {}, "source": [ "È anche possibile annullare un lavoro in qualsiasi momento:\n", "\n" ] }, { "cell_type": "code", "execution_count": 11, "id": "bc4fbe20-456c-4ce4-bf26-dfdb8b68e89f", "metadata": {}, "outputs": [ { "data": { "text/plain": [ "'Job has been stopped.'" ] }, "execution_count": 11, "metadata": {}, "output_type": "execute_result" } ], "source": [ "job.stop()" ] }, { "cell_type": "markdown", "id": "925a8d81-e85b-4e26-a9e1-3a01e8e0785b", "metadata": {}, "source": [ "Una volta che un programma è `DONE`, è possibile utilizzare `job.results()` per recuperare il risultato memorizzato in `save_result()`:\n", "\n" ] }, { "cell_type": "code", "execution_count": 12, "id": "c0d999d9-af9e-4312-b5bb-f60f714257ba", "metadata": {}, "outputs": [ { "data": { "text/plain": [ "{'transpiled_circuits': [,\n", " ,\n", " ,\n", " ,\n", " ,\n", " ,\n", " ,\n", " ,\n", " ,\n", " ]}" ] }, "execution_count": 12, "metadata": {}, "output_type": "execute_result" } ], "source": [ "# We can't get results from a cancelled job, so we'll fetch a completed one instead\n", "completed_job = next(\n", " job for job in serverless.jobs() if job.status() == \"DONE\"\n", ")\n", "completed_job.result()" ] }, { "cell_type": "markdown", "id": "ca9791df-60c2-49d8-8541-741078ea63c6", "metadata": {}, "source": [ "\n", "\n", "## Elenca i lavori eseguiti in precedenza con Qiskit Serverless\n", "\n", "È possibile utilizzare `jobs()` per elencare tutti i lavori inviati a Qiskit Serverless:\n", "\n" ] }, { "cell_type": "code", "execution_count": 13, "id": "ba9365c4-b07d-4dc6-9594-edc07c44bc63", "metadata": {}, "outputs": [ { "data": { "text/plain": [ "[,\n", " ,\n", " ,\n", " ,\n", " ,\n", " ,\n", " ,\n", " ,\n", " ,\n", " ]" ] }, "execution_count": 13, "metadata": {}, "output_type": "execute_result" } ], "source": [ "old_jobs = serverless.jobs()\n", "old_jobs" ] }, { "cell_type": "markdown", "id": "fd3415a0-0e55-4991-8764-c9fe66eb2664", "metadata": {}, "source": [ "\n", "\n", "## Passi successivi\n", "\n", "\n", " * Esplora [gli strumenti di elaborazione e gestione dei dati](/docs/guides/serverless-manage-resources) disponibili per il tuo programma, compresa la parallelizzazione.\n", "\n", "\n" ] }, { "cell_type": "markdown", "metadata": {}, "id": "a1b8767d", "source": "© IBM Corp., 2017-2026" } ], "metadata": { "kernelspec": { "display_name": "Python 3", "language": "python", "name": "python3" }, "language_info": { "codemirror_mode": { "name": "ipython", "version": 3 }, "file_extension": ".py", "mimetype": "text/x-python", "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", "version": "3" } }, "nbformat": 4, "nbformat_minor": 2 }