Azure Quantum'da sık karşılaşılan sorunları giderme

Azure Quantum hizmetiyle çalışırken bu yaygın sorunlarla karşılaşabilirsiniz. Bunları nasıl çözebileceğinize bakın.

İşler gönderiliyor

Sorun: Eksik targets

İşinizi target çalıştırmak istediğiniz yer kullanılabilir target listede yoksa, büyük olasılıkla Visual Studio Code'un en son sürümüne Quantum Development Kit güncelleştirmeniz gerekir. Daha fazla bilgi için bkz . QDK'yi güncelleştirme.

Sorun: İşlem geçersiz bir 'Yetkisiz' durum kodu döndürüyor

Bu sorunu çözme adımları:

1. Azure portalınızı (https://portal.azure.com) açın ve hesabınızın kimliğini doğrulayın.

2. Gezin'in altında Abonelikler'i ve ardından aboneliğinizi seçin.

3. Erişim denetimi (IAM) öğesini seçin.

4. Erişimi denetle'nin altında e-posta adresinizi arayın ve hesabı seçin.

5. Listede Sahip veya Katkıda Bulunan rolü görmemeniz gerekir.

6. Rol atamaları sekmesini seçin.

   Not

   Rol atamaları sekmesini görmüyorsanız portalı tam ekran olarak genişletmeniz veya ad> atamalarınız bölmesini kapatmanız <gerekebilir.

7. Rol açılan listesini seçin, Sahip veya Katkıda Bulunan'ı seçin, ardından e-posta adresinizi girin ve hesabınızı seçin.

8. Kaydet'i seçin.

9. Artık hesap kümenizin Sahip veya Katkıda Bulunan rolüyle yapılandırıldığını görmeniz gerekir.

10. Azure Quantum çalışma alanınızı yeniden oluşturun ve ardından bu yeni Çalışma Alanına karşı bir iş gönderin.

Sorun: "AuthorizationFailure - Bu isteğin bu işlemi gerçekleştirme yetkisi yok"

Azure Quantum hizmetine geçerli bir bağlantınız olmasına rağmen bir iş gönderimi bu iletiyle başarısız olursa, depolama hesabı genel ağ erişimini engelleyecek şekilde yapılandırılabilir. Azure Quantum hizmeti yalnızca genel İnternet erişimi aracılığıyla depolama hesaplarını destekler.

Depolama hesabını denetlemek için:

• Azure Portal'daki kuantum çalışma alanı sayfasında Genel Bakış'ı ve ardından depolama hesabını seçin.
• Depolama hesabı sayfasındaki Güvenlik + ağ bölümünde Ağ'ı seçin.
• Genel ağ erişimi'nin Güvenlik duvarları ve sanal ağlar sekmesinde Tüm ağları etkinleştir'in seçili olduğundan emin olun.

Sorun: CLI aracılığıyla bir Q# programı göndermeye çalışırken "Program derlenemiyor"

komutunu kullanarak az quantum submit komut isteminde bir iş göndermeye çalışırken aşağıdaki hata iletisiyle karşılaşabilirsiniz:

az quantum job submit ...
Failed to compile program.
Command ran in 21.181 seconds (init: 0.457, invoke: 20.724)

Bu hata, derlemenin başarısız olmasına neden olan Q# programıyla ilgili bir sorun olduğunda oluşur.

Sorun: Derleyici hatası "Yanlış sayıda geçit parametresi"

Yerel bir Jupyter Notebook veya komut satırı ortamından Quantinuum'a iş gönderirken ve eski QASM çeviricisini (OPENQASM 2.0) kullanırken şu hatayla karşılaşabilirsiniz:

Job ID <jobId> failed or was cancelled with the message: 1000: Compile error: [<file, line>] Wrong number of gate parameters

Bu hata, birçok dilde yaygın olarak olduğu gibi ondalık ayırıcı olarak virgül "," veya başka bir nokta olmayan karakter kullanıldığında oluşur. Nokta olmayan ondalık ayırıcıları "." noktalarıyla değiştirin.

// replace this line:
rx(1,5707963267948966) q[0];

// with this:
rx(1.5707963267948966) q[0];

Not

Bu sorun, Azure Quantum portalında barındırılan not defterlerinde değil, yalnızca yerel geliştirme ortamlarında oluşmaz.

Sorun: Derleyici hatası "geçerli derleme yapılandırması için kullanılamıyor"

VS Code'da Jupyter Not Defteri'nde Q# kod hücresi çalıştırdığınızda şu hatayla karşılaşabilirsiniz:

<function name> not found. Found a matching item `<function name>' that is not available for the current compilation configuration

Bu hata, QIR target profilinin Temel olarak ayarlandığını ve söz konusu işlevin Sınırsıztarget profil gerektirdiğini gösterir. Profili Sınırsız olarak ayarlamak target için:

1. VS Code'da Q# programınızdayken, alt durum çubuğunda Q#: QIR tabanı'nı seçin.
2. Üst durum çubuğunda görüntülenen seçeneklerden Q#: sınırsız'ı seçin.

Sorun: İşlem geçersiz bir 'Yasak' durum kodu döndürdü

İlk işinizi gönderdiğinizde 'yasak' hata kodu alabilirsiniz.

Bu sorun çalışma alanı oluşturma sırasında kaynaklanabilir: Azure Quantum, yeni çalışma alanını belirtilen depolama hesabına bağlayan rol atamasını tamamlayamaz. Bu durum için tipik bir senaryo, çalışma alanı oluşturma işlemi tamamlanmadan önce sekme veya web tarayıcısının kapatılmasıdır.

Aşağıdaki adımları izleyerek bu rol ataması sorunuyla karşılaşdığınızı doğrulayabilirsiniz:

• Azure Portal'da yeni kuantum çalışma alanınıza gidin
• Genel Bakış>Temel>Depolama hesabı'nın altında depolama hesabı bağlantısını seçin
• Sol gezinti çubuğunda Erişim Denetimi (IAM) öğesini seçin
• Rol Atamaları’nı seçin
• Çalışma alanınızın Katkıda Bulunan olarak göründüğünü doğrulayın
• Çalışma alanı Katkıda Bulunan olarak görünmüyorsa şunlardan birini yapabilirsiniz:
  • Yeni bir çalışma alanı oluşturun ve web tarayıcısı sekmesini veya penceresini kapatmadan önce çalışma alanı oluşturma işleminin tamamlanmasını beklediğinden emin olun.
  • Depolama hesabının altına uygun rol atamasını ekleme
    • Erişim Denetimi (IAM) > Rol atamaları ekleme
    • Rol > Katkıda Bulunanı
    • Kullanıcı, grup veya hizmet sorumlusuna > erişim atama
    • [Çalışma alanı adı] öğesini seçin >
    • Kaydet

Sorun: İş hata koduyla başarısız oluyor: QIRPreProcessingFailed

Rigetti sağlayıcısına bir iş gönderdiğinizde iş başarısız olur ve Azure portalındaki İş yönetimi konsolunda bildirilir:

Error code: QIRPreProcessingFailed
Error message: No match found for output recording set converter from outputrecordingset.v2.labeled to outputrecordingset.v1.nonlabeled

Bu hataya pyqir veya qiskit-qir'in önceki bir sürümüyle bağımlılık çakışması neden olabilir. Yerel makinenizde tüm pyqir, pyqir-*ve qiskit-qir sürümlerini kaldırın ve ardından [qiskit] parametresini kullanarak azure-quantum Python paketini yükleyin veya güncelleştirin:

pip install --upgrade azure-quantum[qiskit]

Sorun: Başarısız işler hakkında temel bilgileri alma

Bir işi bir donanıma targetgönderdikten sonra, işiniz başarısız olmadan önce birkaç saat, hatta bir veya iki gün kuyrukta kalabilir.

Hata hakkında daha fazla bilgi almak için:

• Çıktıyı get_results() veya döndürülen hata iletisini görüntülemek için job nesnesiyle yöntemini kullanın:

job.get_results()

• Azure Portal çalışma alanınızda İşlemler > İş Yönetimi'ni seçin ve ardından iş Adı'nı seçerek bir ayrıntı bölmesi açın.
• Azure Portal çalışma alanınızda İşlem > Sağlayıcıları'yı seçin. Makinenin kullanılabilirliğini target doğrulayın. Durumu Düşürülmüş olarak gönderilen targets işler normalden daha uzun kuyrukta kalabilir. Bazen işler işlenir, ancak bazen zaman aşımına neden olur ve kullanılamaz hatası target döndürür.

Sorun: Çalışma alanıma program aracılığıyla bağlanırken kimlik doğrulamam istenmeye devam ediyor

Azure Quantum Python SDK'sını kullanıyorsanız (örneğin Jupyter not defterleri içinde) ve AzureQuantumProvider sınıfını kullanarak çalışma alanınıza bağlanıyorsanız, betiğinizi her çalıştırdığınızda Azure'da kimlik doğrulaması yapmak için bir açılır pencereyle karşılaşabilirsiniz.

Bunun nedeni, betiği her çalıştırdığınızda güvenlik belirtecinizin sıfırlanmasıdır.

Azure CLI'yi kullanarak çalıştırarak az login bu sorunu çözebilirsiniz. Daha fazla bilgi için bkz . az login.

Sorun: Azure-quantum paketini güncelleştirdikten sonra bir işi izlerken "ModuleNotFoundError: qiskit.tools adlı modül yok" hatasını alıyorum

Qiskit 1.0 itibarıyla qiskit.tools işlev için job_monitor() gerekli olan modül kullanım dışı bırakılmıştır. İşleri izlemek için veya result işlevlerini kullanınwait_for_final_state().

job = MyTarget.run(circuit, shots=100)

# to wait until the job is complete
job.wait_for_final_state() 

# to return the results of the job
result = job.result()

Azure Quantum Kaynak Tahmin Aracı

Aşağıdaki yaygın senaryolar kaynak tahmin işlerinin tamamlanmasını engelleyebilir. Bunların nasıl çözüleceğini görün.

Sorun: Kuantum algoritması en az bir T durumu veya ölçümü içermelidir

Rastgele bir kuantum programını 2B bir mantıksal kubit dizisine eşlemeyi hesaba katmak için Kaynak Tahmin Aracı, Paralel Sentez Sıralı Pauli Hesaplaması'nın (PSSPC) (bkz. arXiv:2211.07629, Ek D) girişprogramı üzerinde gerçekleştirildiğini varsayar. Bu yaklaşımda, tüm Clifford operasyonları tüm T kapılarından, dönüş kapılarından ve ölçüm işlemlerden geçirilir ve klasik olarak verimli bir şekilde değerlendirilebilecek tek bir Clifford operasyonu bırakılır. Bu nedenle, T geçitleri veya döndürme geçitleri gibi T durumlarını veya ölçüm işlemlerini içeren bir kuantum programı herhangi bir fiziksel kuantum bilgi işlem kaynağı gerektirmez.

Error message: Algorithm requires at least one T state or measurement to estimate resources

Sorun: Fiziksel T kapısı hata oranı çok yüksek

Mantıksal T durumu hata oranı, hata bütçesine ve kuantum programındaki T durumlarının sayısına bağlıdır. T fabrikaları, fiziksel T kapısı hata oranına sahip olan fiziksel T kapılarından gerekli mantıksal T durumu hata oranına sahip T durumları oluşturmak için kullanılır. Genellikle, fiziksel T kapısı hata oranı gerekli mantıksal T kapısı hata hızından çok daha yüksektir. Bazı senaryolarda fiziksel T kapısı hata oranı, gerekli mantıksal T durumu hata oranına kıyasla çok daha yüksektir; böylece yeterli kalitede mantıksal T durumları üretebilecek T fabrikası bulunamaz.

Error message: No T factory can be found, because the required logical T state error rate is too low

Böyle bir senaryoda şunları yapabilirsiniz:

• Toplam veya T durumlarının hata bütçesini artırın.
• Kubit parametrelerindeki fiziksel T kapısı hata oranını azaltın.
• T geçitlerini, dönüş geçitlerini ve Toffoli geçitlerini azaltarak kuantum programındaki T durumlarının sayısını azaltın.

Sorun: Fiziksel T kapısı hata oranı çok düşük

Fiziksel T kapısı hata oranının gerekli mantıksal T durumu hata hızından düşük olduğu karşıt senaryo da vardır. Bu gibi durumlarda, fiziksel T kapısı hata oranı zaten yeterli kalitede olduğundan T fabrikası gerekmez. Ancak bu, fiziksel T durumlarını kod uzaklığı 1'den algoritmanın kod mesafesine aktaran aktarım birimlerinin etkisinin dikkatli bir şekilde dikkate alınmasını gerektirir (bkz . arXiv:2211.07629, Ek C). Genel olarak, T fabrikalarının varlığında, transfer birimlerinin maliyeti göz ardı edilebilir.

Error message: No T factory can be found, because the required logical T state error rate is too high; transfer units are necessary to perform a resource estimation accurately. One possibility to circumvent this problem is to increase the physical T gate error rate of the qubit parameters.

Böyle bir senaryoda şunları yapabilirsiniz:

• Kubit parametrelerindeki fiziksel T kapısı hata oranını gerekli mantıksal T durumu hata oranına yükseltin.
• Hata bütçesini veya yalnızca T durumlarının bölümünü azaltın.

Sorun: Hata oranı 0 ile 1 arasında bir sayı olmalıdır

Hata oranları her zaman 0 ile 1 arasındaki değerler olmalıdır. Ayrıca, hata düzeltmesinin etkili olması için geçitler ve ölçümler için fiziksel hata oranı, hata düzeltme kodunun özelliklerine ve gerekli mantıksal hata oranına bağlı olan bir değerin altında olmalıdır.

Böyle bir senaryoda şunları yapabilirsiniz:

• Toplam veya mantıksal hataların parçası olan hata bütçesini artırın.
• Kubit parametrelerindeki fiziksel hata oranlarını azaltın.

Sorun: Çalışma zamanı üst sınırı ve fiziksel kubit sayısı üst sınırı birbirini dışlar

Kaynak Tahmin Aracı, aynı anda yalnızca birini maxDuration veya maxPhysicalQubits kısıtlamalarını kabul eder, ancak ikisini kabul etmemektedir. Tek bir iş için hem hem de maxDurationmaxPhysicalQubitskısıtlamaları sağlarsanız hata döndürür BothDurationAndPhysicalQubitsProvided .

Sorun: QIR tahmin sayıları kapsayıcısı çalıştırma: tanımlanmamış simge __quantum__rt__result_record_output

Bu hata, parametresini Falseolarak ayarlamadan qiskit_qir Python paketi aracılığıyla Qiskit bağlantı hatları için QIR oluşturulmasından kaynaklanırrecord_output.

Bu hatayı önlemek için aşağıdakilerden birini yapın:

• Qiskit bağlantı hatlarını Azure Quantum'a göndermek için azure_quantum Python paketini kullanın (önerilir).
• qiskit_qir Python paketini kullanırken, bağlantı hattınızı göndermeden önce parametresini record_output olarak False ayarladığınızdan emin olun.

Azure Quantum çalışma alanı oluşturma

Çalışma alanı oluşturmak için Azure portalını kullandığınızda aşağıdaki sorunlar oluşabilir.

Sorun: Azure portalında çalışma alanı oluşturma formuna erişemezsiniz; bunun yerine bir aboneliğe kaydolmanız istenir

Etkin bir aboneliğiniz olmadığından bu sorun oluşur.

Örneğin, Azure hizmetlerinde kullanmak üzere 200 ABD doları ücretsiz Azure Kredisi içeren 30 günlük ücretsiz deneme Azure aboneliğine kaydolabilirsiniz. Bu Azure kredilerinin Azure Quantum Kredileri ile aynı olmadığını ve kuantum donanım sağlayıcılarında kullanılmaya uygun olmadığını unutmayın. Kaydolduktan 30 gün sonra veya 200 ABD doları ücretsiz Azure kredisini (hangisi önce gerçekleşirse) kullandıktan sonra Azure Quantum hizmetlerini kullanmaya devam etmek için kullandıkça öde aboneliğine yükseltmeniz gerekir. Etkin bir aboneliğiniz olduğunda Azure portalı çalışma alanı oluşturma formuna erişmenizi sağlar.

Aboneliklerinizin ve ilişkili rollerinizin listesini görmek için bkz . Aboneliklerinizi denetleme.

Sorun: Hızlı oluşturma seçeneği kullanılamıyor

Hızlı oluşturma seçeneğini kullanabilmek için seçtiğiniz aboneliğin Sahibi olmanız gerekir. Aboneliklerinizin ve ilişkili rollerinizin listesini görmek için bkz . Aboneliklerinizi denetleme. Abonelik Katkıda Bulunanıysanız, bir çalışma alanı oluşturmak için Gelişmiş oluşturma seçeneğini kullanabilirsiniz.

Sorun: Kaynak grubu veya depolama hesabı oluşturamazsınız veya seçemezsiniz

Bu sorun, abonelik, kaynak grubu veya depolama hesabı düzeyinde gerekli yetkilendirmeye sahip olmadığınız için oluşur. Gerekli erişim düzeyleri hakkında daha fazla bilgi için bkz . Çalışma alanı oluşturmak için rol gereksinimleri.

Sorun: Oluştur'u seçtikten sonra "Dağıtım Doğrulaması Başarısız Oldu" hata iletisi görüntüleniyor

Bu hata iletisi "İstemcinin eylem gerçekleştirme yetkisi yok" gibi daha fazla ayrıntı içerebilir.

Bu sorun, abonelik, kaynak grubu veya depolama hesabı düzeyinde gerekli yetkilendirmeye sahip olmadığınız için oluşur. Gerekli erişim düzeyleri hakkında daha fazla bilgi için bkz . Çalışma alanı oluşturmak için rol gereksinimleri.

Erişim kısa süre önce verildiyse, sayfayı yenilemeniz gerekebilir. Yeni rol atamalarının yığın genelinde önbelleğe alınmış izinler üzerinde etkili olması bazen bir saate kadar sürebilir.

Sorun: Sağlayıcılar sekmesinde belirli bir kuantum donanım sağlayıcısını görmüyorsunuz

Bu sorun, sağlayıcının aboneliğinizin ayarlandığı faturalama bölgesini desteklememesi nedeniyle oluşur. Örneğin aboneliğiniz İsrail'de ayarlandıysa Sağlayıcılar sekmesi Rigetti'yi kullanılabilir bir sağlayıcı olarak listelemez. Sağlayıcıların listesi ve bunların ülkeye/bölgeye göre kullanılabilirliği için bkz . Azure Quantum sağlayıcılarının genel kullanılabilirliği.

Sorun: Çalışma alanı oluşturma veya sağlayıcı ekleme/kaldırma işlemi "ResourceDeploymentFailure" veya "ProviderDeploymentFailure" ile başarısız oluyor

Bu sorun, "ResourceDeploymentFailure - 'AzureAsyncOperationWaiting' kaynak işlemi terminal sağlama durumu 'Failed' ile tamamlandı" veya "ProviderDeploymentFailure - Sağlayıcı için plan oluşturulamadı: <Sağlayıcının> adı" gibi daha fazla ayrıntı içerebilir.

Bunun nedeni kiracının Azure Market satın almaları etkinleştirmemesidir. Azure Market satın almaları etkinleştirmek için Azure Market satın almaları etkinleştirme'deki adımları izleyin.

Sorun: Kuantum çalışma alanı dağıtma veya depolama hesabı dağıtma işlemi aşağıdaki hatalardan biriyle başarısız oluyor:

• Çalışma alanı: "Kaynak yazma işlemi başarıyla tamamlanamadı, çünkü 'Başarısız' terminal sağlama durumuna ulaştı".
• Depolama hesabı: "İlke ihlali nedeniyle şablon dağıtımı başarısız oldu".

Abonelik güvenlik ilkeniz genel erişimi etkinleştirilmiş depolama hesaplarının oluşturulmasını engellerse bu sorun oluşabilir. Azure Quantum hizmeti yalnızca genel İnternet erişimi aracılığıyla depolama hesaplarını destekler.

Bu sorunu çözmek için abonelik yöneticinizle birlikte çalışarak kullanmak istediğiniz depolama hesabı için bir özel durum alın.

Azure Quantum portalı

Sorun: Kaydedilen not defterleri yüklenemiyor

Çalışma alanınızda Not Defterleri'ni seçtikten sonra, kaydedilen not defterlerinizin listesi bir ilerleme çubuğu görüntüler ancak hiçbir zaman yüklenmez.

Bunun üç nedeni olabilir:

1. Depolama hesabı artık yoksa. Çalışma alanına bağlı depolama hesabı silindiyse bu durum oluşabilir. Doğrulamak için çalışma alanının Genel Bakış sayfasını seçin ve depolama hesabının bağlantısını seçin. Depolama hesabı silinmişse 404 - Bulunamadı hatası görürsünüz.

2. Depolama hesabı genel İnternet erişimi için etkinleştirilmemişse. Daha fazla bilgi için bkz . Yetkilendirme hatası .

3. Çalışma alanının yönetilen kimliği depolama hesabına katkıda bulunan değilse. Çalışma alanı kimliğinin (çalışma alanıyla aynı adı kullanan) depolama hesabına Katkıda Bulunan rolü atamasına sahip olup olmadığını denetleyin. Doğrulamak için çalışma alanının Genel Bakış sayfasını seçin ve depolama hesabının bağlantısını seçin. Depolama hesabının Genel Bakış sayfasında Erişim denetimi (IAM) öğesini seçin ve çalışma alanının Katkıda Bulunan altında listelendiğini doğrulayın.