Azure Quantum sorunlarını giderme

Azure Quantum hizmetiyle çalışırken bağlantı veya işle ilgili sorunlarla karşılaşabilirsiniz. Bu makalede bu sorunların nasıl giderilir açıklanmaktadır.

Çalışma alanı bağlantı sorunları

Sorun: pytket-azure ile Azure Quantum için kimlik doğrulaması yapılamıyorum

pytket-azure, "AZURE_TENANT_ID" ve "AZURE_CLIENT_ID" ortam değişkenlerini kullanarak ci ortamında "AZURE_CLIENT_SECRET" paketiyle Azure Quantum kimlik doğrulaması yapmaya çalıştığınızda, aşağıdaki hatayla karşılaşabilirsiniz:

Code: InsufficientPermissions
Message: There are not enough permissions to perform this operation.

Bu sorunu çözmek için kimlik doğrulamasını gerçekleştirmek amacıyla bağlantı dizesi ve "AZURE_QUANTUM_CONNECTION_STRING" ortam değişkenini kullanın. Daha fazla bilgi için bkz. bağlantı dizesi ile bağlanma.

connection_string = "" # Add your connection string

import os 

os.environ["AZURE_QUANTUM_CONNECTION_STRING"] = connection_string 

İş gönderme sorunları

Sorun: İşimi teslim etmek istediğim target bulamıyorum

Çalıştırmak istediğiniz Azure Quantum target kullanılabilir target listesinde yer almıyorsa, Visual Studio Code (VS Code) için Quantum Development Kit (QDK) en son sürümüne güncelleyin. 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 çözmek için şu adımları izleyin:

1. Azure portalında oturum açın ve hesabınızın kimliğini doğrulayın.
2. İş göndermeye çalıştığınız Quantum çalışma alanına gidin.
3. Çalışma alanı gezinti bölmesinde Erişim denetimi (IAM) öğesini seçin.
4. Erişimimi görüntüle düğmesini seçin. Atamalar bölmesi açılır.
5. Rol atamaları tablosunun Rol sütununda Sahip veya Katkıda Bulunan rolüne sahip olup olmadığınızı denetleyin.
6. Herhangi bir rolünüz yoksa abonelik yöneticinizden size bu çalışma alanı için Sahip veya Katkıda Bulunan rolünü atamasını isteyin.

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

Azure Quantum hizmetine geçerli bir bağlantınız olsa bile bu iletiyi alırsanız, depolama hesabı genel ağ erişimini engelleyecek şekilde yapılandırılabilir. Azure Quantum hizmeti yalnızca genel İnternet erişimi olan depolama hesaplarını destekler.

Depolama hesabı ayarlarını denetlemek için şu adımları izleyin:

1. Azure portalında oturum açın.
2. Quantum çalışma alanınıza gidin.
3. Genel Bakış sayfasında Depolama hesabını seçin.
4. Gezinti bölmesinde Güvenlik + ağ açılan listesini genişletin ve Ağ'ı seçin.
5. Genel erişim sekmesinin Genel ağ erişimi bölümünde Yönet düğmesini seçin.
6. Genel ağ erişimi ayarı için Etkinleştir'i seçin. Genel ağ erişim kapsamı ayarı için Tüm ağlardan etkinleştir'i seçin.
7. Kaydet düğmesini seçin.

Sorun: Azure CLI'dan bir Q# programı gönderdiğinizde "Program derlenemiyor"

az quantum submit Azure CLI komutuyla bir iş gönderdiğinizde 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. Q# kodunuzun doğru söz dizimine sahip olduğundan emin olun.

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

Yerel bir Jupyter Notebook veya CLI ortamından Quantinuum'a iş gönderdiğinizde ve eski QASM (OPENQASM 2.0) çeviricisini kullandığınızda ş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

Ondalık ayırıcı olarak virgül "," veya nokta olmayan başka bir karakter kullanıldığında bu hata oluşur. Nokta olmayan tüm ondalık ayırıcıları "." noktalarıyla değiştirin. Örneğin:

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

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

Sorun: Derleyici hatası "mevcut derleme ayarı için kullanılamıyor"

VS Code'da bir Jupyter Notebook 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, işlev Sınırsız profili gerektirdiğinde QIR (kuantum ara gösterimi) target profilini Temel olarak ayarladığınızı target gösterir. Bir target profil türü belirtmezseniz, derleyici otomatik olarak öğesini target olarak ayarlar.

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

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

Bu sorun, Azure portalında yeni bir çalışma alanı oluşturduğunuzda ve Azure Quantum çalışma alanını belirtilen depolama hesabına bağlayan rol atamasını tamamlayamaması durumunda oluşur. Çalışma alanı oluşturma işlemi tamamlanmadan önce sekmeyi veya web tarayıcısını kapattığınızda bu durum oluşabilir.

Bu rol ataması sorunuyla karşılaşdığınızı doğrulamak için şu adımları izleyin:

1. Azure portalında Quantum çalışma alanınıza gidin.
2. Genel Bakış sayfasında Depolama hesabını seçin.
3. Gezinti bölmesinde Access Control (IAM) öğesini seçin.
4. Rol atamaları sekmesini seçin.
5. Rol sütununda, çalışma alanınızın depolama hesabının Depolama Hesabı Katkıda Bulunanı rolüne ve Depolama Blob Verileri Katkıda Bulunanı rolüne sahip olup olmadığını denetleyin.

Çalışma alanının depolama hesabında bu rollerin ikisi de yoksa aşağıdakilerden birini yapın:

• Yeni bir çalışma alanı oluşturun ve web tarayıcısı penceresini veya sekmesini kapatmadan önce çalışma alanı oluşturma işleminin tamamlandığından emin olun.
• Depolama hesabındaki çalışma alanınıza Depolama Hesabı Katkıda Bulunanı ve Depolama Blob Verileri Katkıda Bulunanı rollerini atayın.

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

Rigetti target bir iş gönderdiğinizde ve iş başarısız olduğunda, Azure portalındaki Quantum çalışma alanınız için Job management konsolunda aşağıdaki hata iletisini görebilirsiniz:

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

Bu hata, pyqir ya da qiskit-qir'nin önceki bir sürümüyle bağımlılık çakışmasından kaynaklanıyor olabilir. Yerel makinenizde tüm pyqir, pyqir-* ve qiskit-qir sürümlerini kaldırın ve ardından qdk Python kitaplığını azure ve qiskit ek özellikleriyle yükleyin veya güncelleştirin:

pip install --upgrade "qdk[azure,qiskit]"

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

Bir işi bir donanıma targetgönderdiğinizde, işiniz başarısız olmadan önce birkaç saat veya gün boyunca kuyrukta kalabilir.

İş hatası hakkında daha fazla bilgi almak için aşağıdakilerden birini yapın:

• İş çıkışını veya hata iletisini görüntülemek için get_results() Python modülünden qdk.azure yöntemini kullanın:

  job.get_results()
  

• Azure portalındaki Quantum çalışma alanınızda, Operations açılan menüsünden Job Management bölmesine gidin ve ardından Job details bölmesini açmak için Name işini seçin.

• Azure portalındaki Quantum çalışma alanınızda, Operations açılan menüsünden Providers bölmesine gidin. Donanımın target mevcut olduğunu doğrulayın. target durum Bozulmuş ise işler normalden daha uzun süre kuyrukta kalabilir. Bazen işler işlenir, ancak bazen zaman aşımına uğrar ve kullanılamaz target hatası döndürürler.

Sorun: Azure Quantum çalışma alanıma program aracılığıyla bağlandığımda kimlik doğrulamamı ister

Azure Quantum Python SDK'sını kullanıyorsanız 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 kimlik doğrulaması yapmak için bir açılır pencereyle karşılaşabilirsiniz.

Bu açılır pencere, betiği her çalıştırdığınızda güvenlik belirtecinizin sıfırlanmasından kaynaklanır.

Bu sorunu çözmek için Azure CLI az login çalıştırın. Daha fazla bilgi için bkz . az login.

Microsoft Quantum kaynak tahmin aracı sorunları

Aşağıdaki sorunlar kaynak tahmin işlerinin başarısız olmasına neden olabilir.

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

Rastgele kuantum programını bir 2B mantıksal kubit dizisine eşlemeyi hesaba eklemek için, kaynak tahmin aracı giriş programında Paralel Sentez Sıralı Pauli Hesaplaması'nın (PSSPC) gerçekleştirildiğini varsayar. Bu yaklaşımda, tüm Clifford işlemleri, T kapıları, dönüş kapıları ve ölçüm işlemleriyle etkileşime girerek, klasik olarak verimli bir şekilde değerlendirilebilecek tek bir Clifford işlemine indirgenir. Bu nedenle, örneğin T kapılarından, döndürme kapılarından veya ölçüm işlemlerinden T durumları içermeyen bir kuantum programı herhangi bir fiziksel kuantum bilgi işlem kaynağı gerektirmez. Paralel Sentez Sıralı Pauli Hesaplaması hakkında daha fazla bilgi için bkz. arXiv:2211.07629, Ek D.

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ılarının hata oranına sahip olduğu 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 daha yüksektir. Bazı senaryolarda, fiziksel T kapısı hata oranı, gerekli mantıksal T durumu hata oranına kıyasla önemli ölçüde 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

Bu sorunu çözümlemek için, aşağıdakilerden birini yapın:

• Toplamı veya T durumlarına ait bölümü artırarak hata bütçesini yükseltin.
• 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ı gerekli mantıksal T durumu hata hızından düşük olduğunda, fiziksel T kapısı hata oranı yeterli olduğundan T fabrikasına ihtiyacınız yoktur. Ancak yine de fiziksel T durumlarını kod uzaklığı 1'den algoritmanın kod uzaklığına aktaran aktarım birimlerinin etkisini göz önünde bulundurmanız gerekir (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.

Bu sorunu çözümlemek için, aşağıdakilerden birini yapın:

• 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 halleri bölümünü azaltın.

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

Hata oranlarının yalnızca 0 ile 1 arasında bir değeri olabilir. 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.

Bu sorunu çözümlemek için, aşağıdakilerden birini yapın:

• 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ı, maxDuration veya maxPhysicalQubits kısıtlamalarından yalnızca birini kabul eder. Tek bir iş için hem maxDuration hem de maxPhysicalQubits kısıtlamalar sağlarsanız, iş BothDurationAndPhysicalQubitsProvided hatasını döndürür.

Sorun: QIR tahmini sayımlar kapsayıcısını çalıştırma: tanımsız sembol __quantum__rt__result_record_output

qiskit_qir Python paketiyle Qiskit bağlantı hatları için QIR oluşturduğunuzda ve record_output parametresini False olarak ayarlamadığınızda bu hatayı alırsınız.

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

• Qiskit bağlantı hatlarını Azure Quantum göndermek için qdk.azure Python modülünü kullanın (önerilir).
• qiskit_qir Python paketini kullandığınızda, bağlantı hattınızı göndermeden önce record_output parametresini False olarak ayarlayın.

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

Azure portalında Kuantum çalışma alanı oluştururken aşağıdaki sorunlarla karşılaşabilirsiniz.

Sorun: Azure portalında çalışma alanı oluşturma formuna erişemezsiniz ve bunun yerine abonelik için kaydolmanız istenir

Bu sorun, etkin bir Azure aboneliğiniz olmadığından oluşur.

30 günlük ücretsiz deneme Azure aboneliğine kaydolduğunda ücretsiz Azure kredi alırsınız. Tüm ücretsiz kredilerinizi kullandıktan veya kaydoldıktan 30 gün 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 Aboneliklerinizi Kontrol Etme bağlantısına bakın.

Not

30 günlük ücretsiz deneme Azure aboneliğinden Azure krediler kuantum donanım sağlayıcılarında kullanılamaz.

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

Hızlı oluşturma seçeneğini kullanmak için aboneliğin Sahibi olmanız gerekir. Aboneliklerinizin ve ilişkili rollerinizin listesini görmek için Aboneliklerinizi Kontrol Etme bağlantısına bakın. 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 Çalışma alanı oluşturmak için rol gereksinimleri başlığına bakın.

Sorun: Oluştur'u seçtiğinizde "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 Çalışma alanı oluşturmak için rol gereksinimleri başlığına bakın.

Kısa süre önce size erişim verildiyse, sayfayı yenilemeniz gerekebilir. Yeni rol atamalarının yığın genelinde önbelleğe alınmış izinler üzerinde etkili olması bir saat 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. 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 Global 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.

Kiracı Azure Market satın almaları etkinleştirmediğinden bu hata oluşur. Azure Market satın almaları etkinleştirmek için Azure Market satın alma işlemleri adımlarını izleyin.

Sorun: Kuantum çalışma alanı veya depolama hesabı dağıtımı başarısız oluyor

Bir Quantum çalışma alanı veya depolama hesabı dağıtmaya çalıştığınızda aşağıdaki hatalardan birini alabilirsiniz:

• Ç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 olan 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.