Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Si tiene un área de trabajo de Azure Quantum, puede usar el módulo qdk.azurePython para conectarse al área de trabajo y enviar el código para que se ejecute en Azure Quantum. El qdk.azure módulo proporciona una Workspace clase que representa un Azure Quantum área de trabajo.
Advertencia
A partir del 11 de enero de 2027, Azure Quantum requiere que los usuarios de un área de trabajo de Quantum tengan el rol Quantum Workspace Data Reader o Quantum Workspace Data Contributor para ver los resultados del trabajo. El rol Colaborador de datos del área de trabajo de Quantum será necesario para enviar trabajos. Para evitar interrupciones en Azure Quantum los flujos de trabajo, asigne estos roles a los usuarios adecuados antes de la fecha límite. Para obtener más información, consulte Asignación de roles de acceso a datos para los usuarios del área de trabajo.
Requisitos previos
Para conectarse al área de trabajo con el qdk.azure módulo, necesita lo siguiente:
Una cuenta de Azure con una suscripción activa. Si no tiene una cuenta de Azure, regístrese gratuitamente y regístrese para obtener una suscripción de pago por uso.
Un área de Azure Quantum trabajo. Si no tiene un espacio de trabajo, consulte Crear un Azure Quantum espacio de trabajo.
La versión más reciente del paquete
qdkPython con el extraazure.pip install --upgrade "qdk[azure]"
Si usa el CLI de Azure, actualice a la versión más reciente. Para obtener instrucciones de instalación, consulte:
- Instalación de CLI de Azure en Windows
- Instalar CLI de Azure en Linux
- Instalar CLI de Azure en macOS
Conexión con una cuenta de Azure
Use una cuenta de Azure para conectarse al espacio de trabajo de Azure Quantum con la extensión Microsoft Quantum Development Kit (QDK) en Visual Studio Code (VS Code).
- Abra VS Code.
- Seleccione Ver>paleta de comandos.
- Entre y seleccione QDK: conectarse a un espacio de trabajo de Azure Quantum.
- Elija Azure cuenta.
- Cuando un mensaje de VS Code indica que QDK desea iniciar sesión, seleccione Permitir.
- Seleccione la cuenta que se va a usar.
- Seleccione un tenant y una suscripción.
Para ver el área de trabajo de Azure Quantum, seleccione el icono de Microsoft Quantum de la barra de actividades.
Conexión con una cadena de conexión
Nota:
Las cadenas de conexión son menos seguras que una cuenta de Azure.
Utilice una cadena de conexión para especificar los parámetros de conexión de un área de trabajo de Azure Quantum. Las cadenas de conexión son útiles cuando:
- Quiere compartir el acceso al área de trabajo con otros usuarios que no tengan una cuenta de Azure.
- Quiere compartir el acceso al área de trabajo con otros usuarios durante un tiempo limitado.
- No se puede usar Microsoft Entra ID debido a las directivas de la empresa.
Sugerencia
Cada Azure Quantum área de trabajo tiene una clave principal y una clave secundaria, y cada clave tiene su propia cadena de conexión. Para permitir que otros usuarios usen el área de trabajo, comparta la clave secundaria y mantenga la clave principal para sus propios servicios. De este modo, puede reemplazar la clave secundaria sin provocar tiempo de inactividad en los servicios. Para obtener más información sobre cómo compartir el acceso al área de trabajo, consulte Uso compartido del acceso al área de trabajo.
Copiar la cadena de conexión
- Inicie sesión en Azure Portal.
- Vaya al Azure Quantum área de trabajo.
- En el panel del área de trabajo, expanda la lista desplegable Operaciones y seleccione Claves de acceso.
- Si el control deslizante Teclas de acceso está establecido en Deshabilitado, establézcalo en Habilitado.
- Seleccione el icono Copiar del cadena de conexión que desea copiar. Puede elegir la cadena de conexión principal o secundaria.
Advertencia
Almacenar las claves de acceso de la cuenta o las cadenas de conexión en texto no cifrado es un riesgo de seguridad. Almacene las claves de la cuenta en un formato cifrado o migre las aplicaciones para que usen la autorización de Microsoft Entra para el área de trabajo de Azure Quantum.
Usa la cadena de conexión para acceder a tu Azure Quantum área de trabajo
Utilice la cadena de conexión que copió para conectarse al Azure Quantum área de trabajo con el qdk.azure módulo o la QDK extensión en VS Code.
Para conectarse al espacio de trabajo Azure Quantum, elija uno de los métodos siguientes.
Use la
from_connection_stringfunción para crear unWorkspaceobjeto .from qdk.azure import Workspace connection_string = "<ConnectionString>" # Replace with your connection string workspace = Workspace.from_connection_string(connection_string) print(workspace.get_targets())Almacene la cadena de conexión en una variable de entorno.
import os from qdk.azure import Workspace connection_string = "<ConnectionString>" # Replace with your connection string os.environ["AZURE_QUANTUM_CONNECTION_STRING"] = connection_string workspace = Workspace() print(workspace.get_targets())
Para obtener más información sobre cómo trabajar con claves, consulte Autenticarse en el área de trabajo mediante una clave de acceso.
Importante
Si deshabilita las claves de acceso para el área de trabajo, no puede conectarse con cadenas de conexión. Utilice los parámetros del área de trabajo en su lugar.
Conéctese a su área de trabajo usando parámetros del workspace
Cada Azure Quantum área de trabajo tiene un conjunto único de parámetros que usas para conectarte al área de trabajo.
| Parámetro | Descripción | Usa cuando te conectes con |
|---|---|---|
subscription_id |
Id. de suscripción de Azure. | Azure CLI |
resource_group |
El nombre del grupo de recursos de Azure. | Azure CLI |
name |
El nombre del área de trabajo de Azure Quantum. | Azure CLI |
resource_id |
Identificador de recurso Azure del Azure Quantum área de trabajo. | Python |
Para buscar los parámetros del área de trabajo, siga estos pasos:
- Inicie sesión en Azure Portal.
- Vaya al Azure Quantum área de trabajo.
- En el panel del área de trabajo, seleccione Información general.
- Despliegue el desplegable Essentials.
- Copie los parámetros de los campos correspondientes.
Nota:
Asegúrese de iniciar sesión en el inquilino correcto antes de conectarse al área de trabajo. Para obtener más información sobre los inquilinos, consulte Cómo administrar suscripciones de Azure con la CLI de Azure.
User parámetros del área de trabajo para conectarse al área de trabajo de Azure Quantum
Para mantener la sesión iniciada al ejecutar los Python scripts, abra un terminal y ejecute el siguiente CLI de Azure comando para establecer la suscripción para el área de trabajo. Reemplace <subscriptionId> con el Id. de suscripción.
az account set --subscription <subscriptionId>
Utilice los parámetros del área de trabajo para conectarse al área de trabajo de Azure Quantum a través del módulo qdk.azure o CLI de Azure.
Para conectarse al área de trabajo Azure Quantum, elija una de las siguientes opciones.
Especifique el identificador de recurso (recomendado):
from qdk.azure import Workspace workspace = Workspace(resource_id="") # Add the resource ID of your workspaceEspecifique el identificador de suscripción, el grupo de recursos y el nombre del área de trabajo:
from qdk.azure import Workspace workspace = Workspace( subscription_id="", # Add the subscription ID of your workspace resource_group="", # Add the resource group of your workspace name="" # Add the name of your workspace )Especifique solo el nombre del área de trabajo. Esta opción podría producir un error si tiene varias áreas de trabajo con el mismo nombre en el mismo tenant.
from qdk.azure import Workspace workspace = Workspace(name="") # Add the name of your workspace