Değişken kitaplıklarındaki değişken türleri

Microsoft Fabric'teki değişken kitaplığı, değişkenlerin tanımını ve yönetimini merkezileştiren, çalışma alanları ve öğeler arasında ölçeklenebilir ve otomatik yapılandırma sağlayan özel bir öğedir.

Değişken kitaplığındaki değişkenler temel veya gelişmiş türler olabilir ve her değişken, kitaplık öğesi içindeki adıyla benzersiz olarak tanımlanır.

• Değişken Kitaplığı'ndaki temel değişken türleri Boole, DateTime (ISO 8601 UTC biçiminde), Guid, Integer, Number ve String gibi basit veri türlerini içerir. Bunlar, farklı aşamalarda ve ortamlarda doğrudan atanabilen ve kullanılabilen basit değerlerdir.
• Gelişmiş değişken türleri, iç Doku öğelerine veya dış bağlantılara başvurma gibi daha karmaşık kullanım örnekleri için tasarlanmıştır. "Bu türler, belirli Yapı öğelerine işaret etmek için çalışma alanı ve öğe kimliklerini depolayan 'öğe referansı' türlerini içerir."

Değişken kitaplıklarında desteklenen türler

Değişken kitaplığındaki değişkenler aşağıdaki desteklenen değişken türlerine sahiptir

TypeType	Kategori	Description
Boolean	Temel	True/false değerlerini temsil eder.
Integer	Temel	Ondalık içermeyen tam sayılar.
Sayı	Temel	Sayısal değerler, ondalık sayıların da dahil olduğu.
String	Temel	Metin değerleri veya karakter dizileri.
DateTime	Temel	ISO 8601 standart yyyy-MM-ddTHH:mm:ss.xxxZ olarak gösterilen tarih ve saat, burada: yyyy-AA-gg dört basamaklı yıldır ve ardından iki basamaklı ay ve iki basamaklı gün gelir. T , tarih ve saati birbirinden ayırır. HH:mm:ss.xxx , 24 saatlik biçimde iki basamaklı saat, ardından iki basamaklı dakika, iki basamaklı saniye ve üç basamaklı milisaniyedir. Z , saatin Eşgüdümlü Evrensel Saat (UTC) olduğunu gösterir.
Kılavuz	Temel	Ayrı nesne tanımlama için kullanılan genel benzersiz tanımlayıcı.
Öğe referansı	Advanced	Fabric Değişken Kütüphanesi'nin içinde, çalışma alanı kimliğini ve öğe kimliğini depolayarak lakehouse, not defteri veya veri işlem hattı gibi mevcut bir Fabric öğesine başvuruyu tutmak için kullanılır.
Bağlantı başvurusu	Advanced	Dış veri bağlantısının kimliğini (örneğin Snowflake, Azure SQL) depolayan ve öğelerin kimlik bilgilerini veya bağlantı dizelerini eklemeden dış kaynaklara başvurmasını sağlayan çalışma alanı değişkeni.

Değişken özellikleri

Değişken kitaplığındaki her değişken aşağıdaki özelliklere sahiptir:

Mülkiyet	Description
İsim	Değişkenin benzersiz tanımlayıcısı. Betiklerde veya iş akışlarında değişkene başvurmak için kullanılır.
Not (isteğe bağlı)	Değişken hakkında açıklayıcı bir açıklama veya ek açıklama. Bağlam, kullanım notları veya özel yönergeler içerebilir. Maksimum uzunluk: 2.048 karakter.
Türü	Değişkenin veri türünü tanımlar (örneğin, dize, tamsayı, boole, dizi). Değerin nasıl yorumlanıp doğrulandığını belirler.
Varsayılan değer kümesi	Başka bir değer sağlanmayan değişkene atanan ilk değer. İş akışlarında tutarlı bir davranış sağlar. Varsayılan değer kümesi yeniden adlandırılamaz.
Alternatif değer kümeleri (isteğe bağlı)	Belirli koşullar veya senaryolar altında uygulanabilecek ek önceden tanımlanmış değer kümeleri. Ortama özgü yapılandırmalar veya geri dönüş seçenekleri için kullanışlıdır.

Adlandırma kuralları

Değişken adı

Değişken kitaplığı içindeki bir değişkenin adı şu kurallara uygun olmalıdır:

• Boş değil
• Başta veya sonda boşluklar yok
• Harf veya alt çizgiyle başlar
• Harfler, sayılar, altçizgiler ve kısa çizgiler içerebilir
• Uzunluğu 256 karakteri aşmaz

Değişken adı büyük/küçük harfe duyarlı değil.

Bir değişken tanımlı bir değere sahip olduktan sonra, türünü değiştirmeye çalışırsanız bir onay iletişim kutusu görüntülenir. İletişim kutusu, tüm değişken değerlerinin sıfırlanacağı ve bu değişikliğin tüketici öğesi tarafında hataya neden olabilecek bir değişiklik olabileceği konusunda sizi uyarır.

Dikkat edilmesi gerekenler ve sınırlamalar

Boyut sınırlamaları

• Bu gereksinimlerin ikisini de karşıladığınız sürece en fazla1.000 değişken ve 1.000'e kadar değer kümesi olabilir:

  • Alternatif değer kümelerindeki toplam hücre sayısı 10.000'den azdır.
  • Öğenin boyutu 1 MB'ı aşmaz.

  Değişiklikleri kaydettiğinizde bu gereksinimler doğrulanır.

• Not alanında en çok 2.048 karakter olabilir.

• Değer kümesi açıklama alanında en çok 2.048 karakter olabilir.