Aracılığıyla paylaş

Tablo işlevleri

  • Makale

Bu işlevler tablo değerlerini oluşturur ve işler.

Tablo oluşturma

İsim Açıklama
#table Sütunlardan ve satırlardan bir tablo değeri oluşturur.
ItemExpression.From İşlev gövdesi için soyut söz dizimi ağacını (AST) döndürür.
ItemExpression.Item Öğe ifadesindeki öğeyi temsil eden soyut söz dizimi ağacı (AST) düğümü.
RowExpression.Column Satır ifadesi içindeki bir sütuna erişimi temsil eden bir soyut söz dizimi ağacı (AST) döndürür.
RowExpression.From İşlev gövdesi için soyut söz dizimi ağacını (AST) döndürür.
RowExpression.Row Satır ifadesi içindeki bir satırı temsil eden soyut sözdizim ağacı (AST) düğümü.
Table.FromColumns Sütunlar ve belirtilen değerler listesinden bir tablo oluşturur.
Table.FromList Belirtilen bölme işlevini listedeki her öğeye uygulayarak listeyi tabloya dönüştürür.
Table.FromRecords Kayıt listesini tabloya dönüştürür.
Table.FromRows Satır değerleri ve isteğe bağlı sütunlar listesinden bir tablo oluşturur.
Table.FromValue Sağlanan değer veya değerlerden bir sütun içeren bir tablo oluşturur.
Table.WithErrorContext Bu işlev yalnızca iç kullanıma yöneliktir.
Table.View Sorgu ve eylem işlemleri için kullanıcı tanımlı işleyicilerle bir tablo oluşturur veya genişletir.
Table.ViewError Görünümde tanımlanan bir işleyici tarafından (Table.Viewaracılığıyla) atıldığında geri dönüş tetiklemeyecek şekilde değiştirilmiş bir hata kaydı oluşturur.
Table.ViewFunction Görünümde tanımlanmış bir işleyici tarafından engellenebilen bir işlev oluşturur (Table.Viewaracılığıyla).

Dönüşüm

İsim Açıklama
Table.ToColumns Bir tablodan sütun değerlerinin iç içe listelerinin listesini oluşturur.
Table.ToList Belirtilen birleştirme işlevini tablodaki her değer satırına uygulayarak tabloyu listeye dönüştürür.
Table.ToRecords Tabloyu kayıt listesine dönüştürür.
Table.ToRows Tablodan satır değerlerinin iç içe listelerinin listesini oluşturur.

Bilgi

İsim Açıklama
Table.ApproximateRowCount Tablodaki yaklaşık satır sayısını döndürür.
Table.ColumnCount Tablodaki sütun sayısını döndürür.
Table.IsEmpty Tablonun satır içerip içermediğini gösterir.
Table.PartitionValues Bir tablonun nasıl bölümlendiği hakkında bilgi döndürür.
Table.Profile Tablonun sütunlarının profilini döndürür.
Table.RowCount Tablodaki satır sayısını döndürür.
Table.Schema Belirtilen tablonun sütunlarının (şema) açıklamasını içeren bir tablo döndürür.
Tables.GetRelationships Tablo kümeleri arasındaki ilişkileri elde eder.

Satır işlemleri

İsim Açıklama
Table.AlternateRows Başlangıç uzaklığını korur ve ardından aşağıdaki satırları alıp atlayarak devam eder.
Table.Combine Tablo listesini birleştirmenin sonucu olan bir tablo döndürür.
Table.FindText Tabloda verilen metni içeren tüm satırları döndürür.
Table.First İlk satırı veya belirtilen varsayılan değeri döndürür.
Table.FirstN Belirtilen ilk sayı satırlarını döndürür.
Table.FirstValue Tablonun ilk satırının ilk sütununu veya belirtilen varsayılan değeri döndürür.
Table.FromPartitions Bölümlenmiş tablo kümesini birleştirmenin sonucu olan bir tablo döndürür.
Table.InsertRows Tabloya belirtilen konumda bir satır listesi ekler.
Table.Last Son satırı veya belirtilen varsayılan değeri döndürür.
Table.LastN Belirtilen son satır sayısını döndürür.
Table.MatchesAllRows Tablodaki tüm satırların verilen koşulu karşılayıp karşılamadığını gösterir.
Table.MatchesAnyRows Tablodaki satırların verilen koşulu karşılayıp karşılamadığını gösterir.
Table.Partition Tabloyu, belirtilen grup ve sütun sayısına göre bir tablo listesine böler.
Table.Range Belirtilen uzaklıkta başlayan satırları döndürür.
Table.RemoveFirstN İlk satırdan başlayarak tablodan belirtilen sayıda satırın kaldırıldığı bir tablo döndürür.
Table.RemoveLastN Son satırdan başlayarak tablodan belirtilen sayıda satırın kaldırıldığı bir tablo döndürür.
Table.RemoveRows Belirtilen satır sayısını kaldırır.
Table.RemoveRowsWithErrors Giriş tablosundan en az bir hücrede hata içeren satırların kaldırıldığı bir tablo döndürür. Bir sütun listesi belirtilirse, yalnızca belirtilen sütunlardaki hücreler hatalar için incelenir.
Table.Repeat Tabloların satırlarını belirtilen sayıda yineler.
Table.ReplaceRows Belirtilen satır aralığını sağlanan satır veya satırlarla değiştirir.
Table.ReverseRows Satırları ters sırada olan bir tablo döndürür.
Table.SelectRows Koşul işlevini karşılayan satırları seçer.
Table.SelectRowsWithErrors Yalnızca giriş tablosunun en az bir hücresinde hata içeren satırları içeren bir tablo döndürür. Bir sütun listesi belirtilirse, yalnızca belirtilen sütunlardaki hücreler hatalar için incelenir.
Table.SingleRow Tabloda tek bir satır döndürür.
Table.Skip İlk belirtilen satır sayısının atlandığı bir tablo döndürür.
Table.SplitAt Belirtilen ilk sayı satırlarını ve kalan satırları içeren bir liste döndürür.

Sütun işlemleri

İsim Açıklama
Table.Column Tablodan belirtilen bir veri sütununu liste olarak döndürür.
Table.ColumnNames Sütun adlarını liste olarak döndürür.
Table.ColumnsOfType Belirtilen türlerle eşleşen sütunların adlarını içeren bir liste döndürür.
Table.DemoteHeaders Sütun üst bilgilerini değerlerin ilk satırına indirger.
Table.DuplicateColumn Belirtilen ada sahip bir sütunu kopyalar. Değerler ve tür kaynak sütundan kopyalanır.
Table.HasColumns Tablonun belirtilen sütunu mu yoksa sütunları mı içerdiğini gösterir.
Table.Pivot Öznitelik-değer çiftlerini temsil eden bir sütun çifti verlendiğinde, öznitelik sütunundaki verileri sütun başlıklarına döndürür.
Table.PrefixColumns Verilen metinle başlayan sütunlara sahip bir tablo döndürür.
Table.PromoteHeaders İlk satırdaki değerleri yeni sütun başlıkları (yani sütun adları) olarak tanımlar.
Table.RemoveColumns Belirtilen sütunları kaldırır.
Table.ReorderColumns Sütunları belirtilen sırada içeren bir tablo döndürür.
Table.RenameColumns Sütunların belirtilen şekilde yeniden adlandırıldığı bir tablo döndürür.
Table.SelectColumns Yalnızca belirtilen sütunları içeren bir tablo döndürür.
Table.TransformColumnNames Verilen işlevi kullanarak sütun adlarını dönüştürür.
Table.Unpivot Tablodaki bir sütun kümesini öznitelik-değer çiftlerine çevirir.
Table.UnpivotOtherColumns Belirtilen küme dışındaki tüm sütunları öznitelik-değer çiftlerine çevirir.

Dönüşüm

İsim Açıklama
Table.AddColumn Belirtilen ada sahip bir sütun ekler. Değer, giriş olarak alınan her satırda belirtilen seçim işlevi kullanılarak hesaplanır.
Table.AddFuzzyClusterColumn Tabloda belirtilen sütunun benzer gruplandırma değerleriyle elde edilen temsili değerlere sahip yeni bir sütun ekler.
Table.AddIndexColumn Açık konum değerlerine sahip bir sütun ekler.
Table.AddJoinColumn Sağlanan sütunlarda tablolar arasında birleştirme gerçekleştirir ve birleştirme sonucunu yeni bir sütunda oluşturur.
Table.AddKey Tabloya anahtar ekler.
Table.AggregateTableColumn Tabloların sütunlarını içeren tabloda birden çok sütuna dönüştürür.
Table.CombineColumns Belirtilen birleştirici işlevini kullanarak belirtilen sütunları yeni bir sütunda birleştirir.
Table.CombineColumnsToRecord Belirtilen sütunları, her kaydın bir araya getirilen sütunların isim ve değerlerine karşılık gelen alan isimleri ve değerlerinin bulunduğu, kayıt türünde yeni bir sütunda birleştirir.
Table.ConformToPageReader Bu işlev yalnızca iç kullanıma yöneliktir.
Table.ExpandListColumn Bir tablodaki liste sütununu göz önünde bulundurarak, listesindeki her değer için bir satırın kopyasını oluşturun.
Table.ExpandRecordColumn Bir kayıt sütununu, değerlerin her biriyle sütunlar halinde genişletir.
Table.ExpandTableColumn Bir kayıt sütununu veya tablo sütununu, içeren tabloda birden çok sütuna genişletir.
Table.FillDown Önceki bir hücrenin değerini sütunda, alttaki null değerli hücrelere yayar.
Table.FillUp Bir hücrenin değerini, sütundaki yukarıda bulunan boş değerli hücrelere yayar.
Table.FilterWithDataTable Bu işlev yalnızca iç kullanıma yöneliktir.
Table.FuzzyGroup Tablodaki satırları, tuşların benzer eşleşmesine göre gruplandırır.
Table.FuzzyJoin Verilen anahtarlara göre bulanık eşleşme yapan iki tablodaki satırları birleştirir.
Table.FuzzyNestedJoin Sağlanan sütunlar kullanılarak tablolar arasında bulanık birleştirme gerçekleştirir ve birleştirme sonucunu yeni bir sütunda üretir.
Table.Group Tablodaki aynı anahtara sahip satırları gruplandırır.
Table.Join Verilen anahtarlara göre eşleşen iki tablodaki satırları birleştirir.
Table.Keys Belirtilen tablonun anahtarlarını döndürür.
Table.NestedJoin Sağlanan sütunlarda tablolar arasında birleştirme gerçekleştirir ve birleştirme sonucunu yeni bir sütunda oluşturur.
Table.ReplaceErrorValues Belirtilen sütunlardaki hata değerlerini ilgili belirtilen değerle değiştirir.
Table.ReplaceKeys Belirtilen tablonun anahtarlarını değiştirir.
Table.ReplaceRelationshipIdentity Bu işlev yalnızca iç kullanıma yöneliktir.
Table.ReplaceValue Belirtilen sütunlarda bir değeri başka bir değerle değiştirir.
Table.Split Belirtilen sayfa boyutunu kullanarak belirtilen tabloyu bir tablo listesine böler.
Table.SplitColumn Belirtilen bölücü işlevini kullanarak belirtilen sütunları ek sütunlar kümesine böler.
Table.TransformColumns Bir veya daha fazla sütunun değerlerini dönüştürür.
Table.TransformColumnTypes Belirli bir kültürü kullanarak { sütun, tür } formunun tür dönüştürmelerini uygular.
Table.TransformRows Belirtilen transform işlevini kullanarak tablonun satırlarını dönüştürür.
Table.Transpose Sütunları satırlara, satırları da sütunlara dönüştürür.

Üyelik

İsim Açıklama
Table.Contains Belirtilen kaydın tabloda satır olarak görünüp görünmediğini gösterir.
Table.ContainsAll Belirtilen kayıtların tümünün tabloda satır olarak görüntülenip görüntülenmeyeceğini gösterir.
Table.ContainsAny Belirtilen kayıtlardan herhangi birinin tabloda satır olarak görüntülenip görüntülenmeyeceğini gösterir.
Table.Distinct Tablodan yinelenen satırları kaldırır.
Table.IsDistinct Tablonun yalnızca ayrı satırlar (yineleme yok) içerip içermediğini gösterir.
Table.PositionOf Tablonun içindeki satırın konumunu veya konumlarını döndürür.
Table.PositionOfAny Tablo içinde belirtilen satırlardan herhangi birinin konumunu veya konumlarını döndürür.
Table.RemoveMatchingRows Belirtilen satırların tüm oluşumlarını tablodan kaldırır.
Table.ReplaceMatchingRows Belirtilen tüm satırları sağlanan satır veya satırlarla değiştirir.

Sipariş

İsim Açıklama
Table.AddRankColumn Bir veya daha fazla sütunun derecelendirilmesini içeren bir sütun ekler.
Table.Max Verilen ölçütleri kullanarak en büyük satırı veya varsayılan değeri döndürür.
Table.MaxN Verilen ölçütleri kullanarak en büyük satırı veya satırları döndürür.
Table.Min Verilen ölçütleri kullanarak en küçük satırı veya varsayılan değeri döndürür.
Table.MinN Verilen ölçütleri kullanarak en küçük satırı veya satırları döndürür.
Table.Sort Tabloyu bir veya daha fazla sütun adı ve karşılaştırma ölçütü kullanarak sıralar.

Diğer

İsim Açıklama
Table.Buffer Bir tabloyu bellekte arabelleğe alır ve değerlendirme sırasında dış değişikliklerden yalıtır.
Table.StopFolding Tüm aşağı akış işlemlerinin verilerin özgün kaynağında çalıştırılmasını engeller.

Parametre Değerleri

Çıkış sütunlarını adlandırma

Bu parametre, sonuçta elde edilen tablonun sütun adlarını belirten metin değerlerinin listesidir. Bu parametre genellikle Table.FromRows ve Table.FromListgibi Tablo oluşturma işlevlerinde kullanılır.

Karşılaştırma ölçütleri

Karşılaştırma ölçütü aşağıdaki değerlerden biri olarak sağlanabilir:

  • Sıralama düzeni belirtmek için bir sayı değeri. Daha fazla bilgi: Sıralama düzeni

  • Sıralama için kullanılacak bir anahtarı hesaplamak için tek bir bağımsız değişkenin işlevi kullanılabilir.

  • Hem anahtar hem de denetim sırası seçmek için karşılaştırma ölçütü, anahtarı ve sırayı içeren bir liste olabilir.

  • Karşılaştırmayı tamamen denetlemek için, sol ve sağ girişler arasındaki ilişki göz önüne alındığında -1, 0 veya 1 döndüren iki bağımsız değişkenin bir işlevi kullanılabilir. Value.Compare bu mantığı devretmek için kullanılabilir.

Örnekler için Table.Sortaçıklamasına gidin.

Sayı veya Koşul ölçütleri

Bu ölçüt genellikle sıralama veya satır işlemlerinde kullanılır. Tabloda döndürülen satır sayısını belirler ve bir sayı veya koşul olmak üzere iki form alabilir.

  • Sayı, uygun işlevle satır içi olarak kaç değer döndürüleceği gösterir.

  • Bir koşul belirtilirse, başlangıçta koşulu karşılayan değerleri içeren satırlar döndürülür. Bir değer koşulda başarısız olduktan sonra başka değer dikkate alınmaz.

Daha fazla bilgi: Table.FirstN, Table.MaxN

Ek değerlerin işlenmesi

Ek değerler, işlevin bir satırdaki ek değerleri nasıl işleyeceklerini belirtmek için kullanılır. Bu parametre, aşağıdaki seçeneklerle eşlenen bir sayı olarak belirtilir:

ExtraValues.List = 0
ExtraValues.Error = 1
ExtraValues.Ignore = 2

Daha fazla bilgi: Table.FromList, ExtraValues.Type

Eksik sütun işleme

Bu parametre, işlevin eksik sütunları nasıl işleyeceklerini belirtmek için kullanılır. Bu parametre, aşağıdaki seçeneklerle eşlenen bir sayı olarak belirtilir:

MissingField.Error = 0
MissingField.Ignore = 1
MissingField.UseNull = 2;

Bu parametre, Table.TransformColumns'deki örnekler için sütun veya dönüştürme işlemlerinde kullanılır. Daha fazla bilgi: MissingField.Type

Sıralama Düzeni

Sıralama düzeni, sonuçların nasıl sıralanması gerektiğini belirtmek için kullanılır. Bu parametre, aşağıdaki seçeneklerle eşlenen bir sayı olarak belirtilir:

Order.Ascending = 0
Order.Descending = 1

Daha fazla bilgi: Order.Type

Denklem ölçütleri

Tablolar için denklem ölçütleri şunlardan biri olarak belirtilebilir:

  • Aşağıdakilerden biri olan bir işlev değeri:

    • Eşitlik ölçütlerini uygulamak için tablodaki sütunu belirleyen bir anahtar seçici.

    • Uygulanacak karşılaştırma türünü belirtmek için kullanılan bir karşılaştırıcı işlevi. Yerleşik karşılaştırıcı işlevleri belirtilebilir. Daha fazla bilgi: Comparer işlevleri

  • Eşitlik ölçütlerini uygulamak için tablodaki sütunların listesi.

Örnekler için Table.Distinctaçıklamasına gidin.