Compartir a través de

Conexión al área de trabajo de Azure Quantum con el módulo de qdk.azure Python

Si tiene un área de trabajo de Azure Quantum, puede conectarse al área de trabajo y enviar el código con el qdk.azure módulo de Python. El qdk.azure módulo proporciona una Workspace clase que representa un área de trabajo de Azure Quantum.

Requisitos previos

Para conectarse al área de trabajo con el qdk.azure módulo, debe tener lo siguiente:

  • Una cuenta de Azure con una suscripción activa. Si no tiene una cuenta de Azure, puede registrarse de forma gratuita y registrarse para obtener una suscripción de pago por uso.

  • Un área de trabajo de Azure Quantum. Si no tiene un área de trabajo, consulte Creación de un área de trabajo de Azure Quantum.

  • La versión más reciente de la qdk biblioteca de Python con el azure adicional.

    pip install --upgrade "qdk[azure]"

Si usa la CLI de Azure, debe tener la versión más reciente. Para obtener instrucciones de instalación, consulte:

Conexión con una cadena de conexión

Puede usar un cadena de conexión para especificar los parámetros de conexión a un área de trabajo de Azure Quantum. Las cadenas de conexión son útiles en los escenarios siguientes:

  • 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 puede usar el identificador de Entra de Microsoft debido a las directivas de empresa.

Sugerencia

Cada área de trabajo de Azure Quantum tiene una clave principal y una clave secundaria, y cada clave tiene su propia cadena de conexión. Para permitir que otros usuarios accedan al área de trabajo, comparta la clave secundaria y use la clave principal solo para sus propios servicios. Puede reemplazar la clave secundaria sin provocar tiempo de inactividad en sus propios 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

  1. Inicie sesión en Azure Portal.
  2. Vaya al área de trabajo de Azure Quantum.
  3. En el panel del área de trabajo, expanda la lista desplegable Operaciones y elija Claves de acceso.
  4. Debe habilitar las claves de acceso para el área de trabajo. Si el control deslizante Claves de acceso está establecido en Deshabilitado, establezca el control deslizante en Habilitado.
  5. Elija el icono Copiar para esa cadena de conexión que desea copiar. Puede elegir la cadena de conexión principal o secundaria.

Advertencia

Es un riesgo de seguridad almacenar las claves de acceso de la cuenta o las cadenas de conexión en texto no cifrado. Se recomienda almacenar las claves de la cuenta en un formato cifrado o migrar las aplicaciones para usar la autorización de Microsoft Entra para acceder al área de trabajo de Azure Quantum.

Uso del cadena de conexión para acceder al área de trabajo de Azure Quantum

Puede usar la cadena de conexión que acaba de copiar para conectarse al área de trabajo de Azure Quantum con el qdk.azure módulo o con Visual Studio Code (VS Code).

Cree un Workspace objeto para conectarse al área de trabajo de Azure Quantum. Hay dos opciones para identificar el área de trabajo de Azure Quantum al crear un Workspace objeto.

  • Llame a la from_connection_string función al crear un Workspace objeto .

    # Create a new Workspace object from a connection string 
from qdk.azure import Workspace 

connection_string = "[Copy connection string]" 
workspace = Workspace.from_connection_string(connection_string) 

print(workspace.get_targets())

  • Si no desea copiar la cadena de conexión en el código, almacene la cadena de conexión en una variable de entorno y use Workspace().

    # Use an environment variable to connect with your connection string

connection_string = "[Copy connection string]" 

import os 

os.environ["AZURE_QUANTUM_CONNECTION_STRING"] = connection_string 

from qdk.azure import Workspace 

workspace = Workspace() 
print(workspace.get_targets())

Para obtener más información sobre cómo habilitar, deshabilitar y volver a generar las claves, consulte Administrar las claves de acceso.

Importante

Si deshabilita las claves de acceso para el área de trabajo, no puede usar cadenas de conexión para conectarse al área de trabajo. Pero todavía puede usar parámetros del área de trabajo para conectarse al área de trabajo.

Conéctese a su área de trabajo usando parámetros del workspace

Cada área de trabajo de Azure Quantum tiene un conjunto único de parámetros que puede usar para conectarse al área de trabajo. Puede usar los parámetros siguientes para conectarse al área de trabajo de Azure:

Parámetro Descripción
subscription_id Id. de suscripción de Azure.
resource_group El nombre del grupo de recursos de Azure.
name Nombre del área de trabajo de Azure Quantum.
location Región de Azure en la que se encuentra el área de trabajo.
resource_id Identificador de recurso de Azure del área de trabajo de Azure Quantum.

Para buscar los parámetros del área de trabajo, siga estos pasos:

  1. Inicie sesión en Azure Portal.
  2. Vaya al área de trabajo de Azure Quantum.
  3. En el panel del área de trabajo, elija Información general.
  4. Despliegue el desplegable Essentials.
  5. Copie los parámetros en sus campos correspondientes.

Nota:

Asegúrese de iniciar sesión en el inquilino correcto antes de conectarse al área de trabajo.

Uso de parámetros del área de trabajo para conectarse al área de trabajo de Azure Quantum

Puede usar los parámetros de su área de trabajo para conectarse a su espacio de trabajo de Azure Quantum con el módulo qdk.azure o con la CLI de Azure.

Cree un Workspace objeto para conectarse al área de trabajo de Azure Quantum. Hay dos opciones para identificar el área de trabajo de Azure Quantum al crear un Workspace objeto.

  • Especifique el identificador de recurso (recomendado):

    from qdk.azure import Workspace 

workspace = Workspace(  
    resource_id = "", # Add the resource ID of your workspace
    location = "" # Add the location of your workspace
    )

  • Especifique el identificador de suscripción, el grupo de recursos y el nombre del área de trabajo y la ubicación:

    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
    workspace_name = "" # Add the name of your workspace
    location = "" # Add the location of your workspace
    )

Contenido relacionado

  • Last updated on