다음을 통해 공유

테이블 함수

  • 아티클

이러한 함수는 테이블 값을 만들고 조작합니다.

테이블 조립

이름 묘사
ItemExpression.From 함수 본문에 대한 AST(추상 구문 트리)를 반환합니다.
ItemExpression.Item 항목 식의 항목을 나타내는 AST(추상 구문 트리) 노드입니다.
RowExpression.Column 행 식 내의 열에 대한 액세스를 나타내는 AST(추상 구문 트리)를 반환합니다.
RowExpression.From 함수 본문에 대한 AST(추상 구문 트리)를 반환합니다.
RowExpression.Row 행 식의 행을 나타내는 추상 구문 트리(AST) 노드입니다.
Table.FromColumns 열 이름과 값이 있는 중첩된 목록이 포함된 목록에서 테이블을 반환합니다.
Table.FromList 목록의 각 항목에 지정된 분할 함수를 적용하여 목록을 테이블로 변환합니다.
Table.FromRecords 레코드 목록에서 테이블을 반환합니다.
Table.FromRows 목록의 각 요소가 단일 행의 열 값을 포함하는 목록인 목록에서 테이블을 만듭니다.
Table.FromValue 제공된 값 또는 값 목록이 포함된 열이 있는 테이블을 반환합니다.
Table.FuzzyGroup 각 행에 대해 지정된 열의 값을 유사하게 일치시켜 테이블의 행을 그룹화합니다.
Table.FuzzyJoin 지정된 키에 따라 유사하게 일치하는 두 테이블의 행을 조인합니다.
Table.FuzzyNestedJoin 제공된 열의 테이블 간에 유사 조인을 수행하고 조인 결과를 새 열에 생성합니다.
Table.Split 지정한 페이지 크기를 사용하여 지정된 테이블을 테이블 목록으로 분할합니다.
Table.WithErrorContext 이 함수는 내부용으로만 사용됩니다.
Table.View 쿼리 및 작업 작업에 대한 사용자 정의 처리기를 사용하여 테이블을 만들거나 확장합니다.
Table.ViewError 뷰에 정의된 처리기(Table.View통해)에 의해 throw될 때 대체(fallback)를 트리거하지 않는 수정된 오류 레코드를 만듭니다.
Table.ViewFunction 뷰에 정의된 처리기가 가로챌 수 있는 함수를 만듭니다(Table.View통해).

변환

이름 묘사
Table.ToColumns 입력 테이블의 값 열을 나타내는 중첩된 목록 목록을 반환합니다.
Table.ToList 테이블의 각 값 행에 지정된 결합 함수를 적용하여 테이블을 목록으로 반환합니다.
Table.ToRecords 입력 테이블에서 레코드 목록을 반환합니다.
Table.ToRows 입력 테이블에서 중첩된 행 값 목록을 반환합니다.

정보

이름 묘사
Table.ApproximateRowCount 테이블의 대략적인 행 수를 반환합니다.
Table.ColumnCount 테이블의 열 수를 반환합니다.
Table.IsEmpty 테이블에 행이 없으면 true를 반환합니다.
Table.Profile 테이블 열의 프로필을 반환합니다.
Table.RowCount 테이블의 행 수를 반환합니다.
Table.Schema 지정한 테이블의 열(즉, 스키마)에 대한 설명이 포함된 테이블을 반환합니다.
Tables.GetRelationships 테이블 집합 간의 관계를 반환합니다.

행 연산

이름 묘사
Table.AlternateRows 테이블의 행을 번갈아 배열한 패턴을 포함하는 테이블을 반환합니다.
Table.Combine 테이블 목록을 병합한 결과인 테이블을 반환합니다. 테이블은 모두 동일한 행 형식 구조를 가져야 합니다.
Table.FindText 셀 중 하나 또는 해당 부분 내에 지정된 텍스트가 있는 행만 포함된 표를 반환합니다.
Table.First 테이블에서 첫 번째 행을 반환합니다.
Table.FirstN countOrCondition 매개 변수에 따라 테이블의 첫 번째 행을 반환합니다.
Table.FirstValue 테이블의 첫 번째 행 또는 지정된 기본값의 첫 번째 열을 반환합니다.
Table.FromPartitions 분할된 테이블 집합을 새 열로 결합한 결과인 테이블을 반환합니다. 열의 형식을 선택적으로 지정할 수 있으며 기본값은 임의입니다.
Table.InsertRows 인덱스의 테이블에 삽입된 행 목록이 있는 테이블을 반환합니다. 삽입할 각 행은 테이블의 행 형식과 일치해야 합니다.
Table.Last 테이블의 마지막 행을 반환합니다.
Table.LastN countOrCondition 매개 변수에 따라 테이블에서 마지막 행을 반환합니다.
Table.MatchesAllRows 테이블의 모든 행이 조건을 충족하는 경우 true를 반환합니다.
Table.MatchesAnyRows 테이블의 행이 조건을 충족하는 경우 true를 반환합니다.
Table.Partition 각 행의 열 값과 해시 함수에 따라 테이블을 그룹 테이블 수 목록으로 분할합니다. 해시 함수는 행의 해시 값을 얻기 위해 행 열의 값에 적용됩니다. 해시 값의 모듈로 연산에 의해 그룹이 결정되며, 이 그룹에 따라 반환된 테이블 중 어느 테이블에 행이 배치될지를 결정합니다.
Table.PartitionValues 테이블을 분할하는 방법에 대한 정보를 반환합니다.
Table.Range 오프셋에서 시작하는 테이블에서 지정된 행 수를 반환합니다.
Table.RemoveFirstN 첫 번째 행에서 시작하여 테이블에서 제거된 지정된 수의 행이 있는 테이블을 반환합니다. 제거된 행 수는 선택적 countOrCondition 매개 변수에 따라 달라집니다.
Table.RemoveLastN 마지막 행에서 시작하여 테이블에서 제거된 지정된 수의 행이 있는 테이블을 반환합니다. 제거된 행 수는 선택적 countOrCondition 매개 변수에 따라 달라집니다.
Table.RemoveRows 오프셋에서 시작하여 테이블에서 제거된 지정된 수의 행이 있는 테이블을 반환합니다.
Table.RemoveRowsWithErrors 행에 있는 셀 중 하나 이상에 오류가 포함된 테이블에서 모든 행이 제거된 테이블을 반환합니다.
Table.Repeat 테이블의 행을 지정한 횟수만큼 반복하여 포함하는 테이블을 반환합니다.
Table.ReplaceRows 지정된 오프셋에서 시작하여 지정된 개수만큼 계속되는 행이 제공된 행으로 바뀐 테이블을 반환합니다.
Table.ReverseRows 행이 역순으로 있는 테이블을 반환합니다.
Table.SelectRows 조건과 일치하는 행만 포함하는 테이블을 반환합니다.
Table.SelectRowsWithErrors 테이블에서 각 행의 셀 중 최소 하나에 오류가 있는 행만 포함된 테이블을 반환합니다.
Table.SingleRow 테이블에서 단일 행을 반환합니다.
Table.Skip 테이블의 첫 번째 행 또는 여러 행을 포함하지 않는 테이블을 반환합니다.
Table.SplitAt 지정된 첫 번째 개수 행과 나머지 행을 포함하는 목록을 반환합니다.

열 작업

이름 묘사
Table.Column 테이블의 열에서 값을 반환합니다.
Table.ColumnNames 테이블에서 열의 이름을 반환합니다.
Table.ColumnsOfType 지정한 형식과 일치하는 열 이름을 가진 목록을 반환합니다.
Table.DemoteHeaders 머리글 행을 테이블의 첫 번째 행으로 강등합니다.
Table.DuplicateColumn 지정된 이름의 열을 복제합니다. 값 및 형식은 원본 열에서 복사됩니다.
Table.HasColumns 테이블에 지정된 열이 포함되어 있는지 여부를 나타냅니다.
Table.Pivot pivotValues가 포함된 테이블 및 특성 열이 지정된 경우 각 피벗 값에 대한 새 열을 만들고 valueColumn에서 값을 할당합니다. 특성 열에서 동일한 키 값이 여러 번 발생하는 것을 처리하기 위해 선택적 aggregationFunction을 제공할 수 있습니다.
Table.PrefixColumns 열에 모두 텍스트 값이 접두사로 추가된 테이블을 반환합니다.
Table.PromoteHeaders 표의 첫 번째 행을 머리글 또는 열 이름으로 승격합니다.
Table.RemoveColumns 특정 열 또는 열들이 제거된 테이블을 반환합니다.
Table.ReorderColumns 서로 상대적인 순서로 특정 열이 있는 테이블을 반환합니다.
Table.RenameColumns 열 이름이 지정된 테이블을 반환합니다.
Table.SelectColumns 특정 열만 포함하는 테이블을 반환합니다.
Table.TransformColumnNames 지정된 함수를 사용하여 열 이름을 변환합니다.
Table.Unpivot 테이블 열 목록을 지정하면 해당 열을 특성-값 쌍으로 변환합니다.
Table.UnpivotOtherColumns 지정된 집합 이외의 모든 열을 특성-값 쌍으로 변환하고 각 행의 나머지 값과 결합합니다.

변형

이름 묘사
Table.AddColumn newColumnName이라는 열을 테이블에 추가합니다.
Table.AddFuzzyClusterColumn 테이블의 지정된 열을 유사 항목으로 그룹화하여 얻은 대표 값으로 구성된 새 열을 추가합니다.
Table.AddIndexColumn 각 행에 대해 테이블의 행 인덱스를 포함하는 특정 이름의 새 열이 있는 테이블을 반환합니다.
Table.AddJoinColumn 특정 열에서 table1과 table2 사이에 중첩 조인을 수행하고 table1의 각 행에 대해 newColumnName 열로 조인 결과를 생성합니다.
Table.AddKey 테이블에 키를 추가합니다.
Table.AggregateTableColumn 특정 열에 중첩된 테이블을 해당 테이블의 집계 값이 포함된 여러 열로 집계합니다.
Table.CombineColumns Table.CombineColumns 결합자 함수를 사용하여 열을 병합하여 새 열을 생성합니다. Table.CombineColumns는 Table.SplitColumn의 역입니다.
Table.CombineColumnsToRecord 지정된 열을 새 레코드 값 열로 결합합니다. 여기서 각 레코드에는 결합된 열의 열 이름과 값에 해당하는 필드 이름과 값이 있습니다.
Table.ConformToPageReader 이 함수는 내부용으로만 사용됩니다.
Table.ExpandListColumn 테이블에 목록이 포함된 열이 있을 경우, 각 목록 값에 대해 행의 복사본을 만듭니다.
Table.ExpandRecordColumn 레코드 열을 각 값이 있는 열로 확장합니다.
Table.ExpandTableColumn 테이블의 레코드 열 또는 테이블 열을 여러 열로 확장합니다.
Table.FillDown 테이블에서 지정된 열 또는 열들에 있는 null 값을 해당 열의 가장 최근 null이 아닌 값으로 바꿉니다.
Table.FillUp 다음 셀의 값이 지정된 열의 위 null 값 셀로 전파되는 테이블에서 표를 반환합니다.
Table.FilterWithDataTable 이 함수는 내부용으로만 사용됩니다.
Table.Group 각 행에 대한 키 열 값으로 테이블 행을 그룹화합니다.
Table.Join table1, key1 및 table2, key2에서 선택한 키 열 값의 같음을 기반으로 table1의 행을 table2의 행과 조인합니다.
Table.Keys 지정된 테이블의 키를 반환합니다.
Table.NestedJoin 키의 같음을 기반으로 테이블의 행을 조인합니다. 결과는 새 열에 입력됩니다.
Table.ReplaceErrorValues 지정된 열의 오류 값을 해당 지정된 값으로 바꿉니다.
Table.ReplaceKeys 지정된 테이블의 키를 바꿉니다.
Table.ReplaceRelationshipIdentity 이 함수는 내부용으로만 사용됩니다.
Table.ReplaceValue 제공된 대체기 함수(예: text.Replace 또는 Value.Replace)를 사용하여 테이블의 특정 열에서 oldValue를 newValue로 바꿉니다.
Table.SplitColumn 단일 열의 각 값을 분할자 함수로 처리하여 새로운 여러 열 집합을 반환합니다.
Table.TransformColumns 하나 이상의 열 값을 변환합니다.
Table.TransformColumnTypes 형식을 사용하여 테이블에서 열 형식을 변환합니다.
Table.TransformRows 변환 함수를 사용하여 테이블에서 행을 변환합니다.
Table.Transpose 입력 테이블에서 열을 행으로, 행을 열로 변환한 테이블을 반환합니다.

회원 자격

이름 묘사
Table.Contains 레코드가 테이블의 행으로 표시되는지 여부를 결정합니다.
Table.ContainsAll 지정한 모든 레코드가 테이블의 행으로 표시되는지 여부를 결정합니다.
Table.ContainsAny 지정한 레코드가 테이블의 행으로 표시되는지 여부를 결정합니다.
Table.Distinct 테이블에서 중복 행을 제거하여 나머지 행이 모두 고유하도록 합니다.
Table.IsDistinct 테이블에 고유 행만 포함되는지 여부를 확인합니다.
Table.PositionOf 테이블 내 행의 위치 또는 위치를 결정합니다.
Table.PositionOfAny 테이블 내에서 지정된 행의 위치 또는 하나 이상의 위치를 결정합니다.
Table.RemoveMatchingRows 테이블에서 행의 모든 항목을 제거합니다.
Table.ReplaceMatchingRows 테이블의 특정 행을 새 행으로 바꿉니다.

주문하기

이름 설명
Table.Max 비교 기준(comparisonCriteria)을 사용하여 테이블에서 가장 큰 행 또는 여러 행을 반환합니다.
Table.MaxN 테이블에서 가장 큰 N행을 반환합니다. 행을 정렬한 후에는 countOrCondition 매개 변수를 지정하여 결과를 추가로 필터링해야 합니다.
Table.Min comparisonCriteria를 사용하여 테이블에서 가장 작은 행 또는 행들을 반환합니다.
Table.MinN 지정된 테이블에서 가장 작은 N행을 반환합니다. 행을 정렬한 후에는 countOrCondition 매개 변수를 지정하여 결과를 추가로 필터링해야 합니다.
Table.AddRankColumn 하나 이상의 다른 열의 순위를 포함하는 열을 추가합니다.
Table.Sort 비교 기준 또는 기본 정렬 순서를 사용하여 테이블의 행을 정렬합니다. 순서를 지정하지 않은 경우에는 기본 정렬 순서를 따릅니다.

다른

이름 설명
Table.Buffer 테이블을 메모리에 버퍼링하여 평가 중에 외부 변경 내용으로부터 격리합니다.

매개 변수 값

출력 열 이름 지정

이 매개 변수는 결과 테이블의 열 이름을 지정하는 텍스트 값 목록입니다. 이 매개 변수는 일반적으로 table 생성 함수(예: Table.FromRows 및 Table.FromList)에서 사용됩니다.

비교 조건

비교 조건은 다음 값 중 하나로 제공할 수 있습니다.

  • 정렬 순서를 지정할 숫자 값입니다. 추가 정보: 정렬 순서

  • 정렬에 사용할 키를 계산하기 위해 하나의 인수 함수를 사용할 수 있습니다.

  • 키와 컨트롤 순서를 모두 선택하려면 비교 기준이 키와 순서를 포함하는 목록일 수 있습니다.

  • 비교를 완전히 제어하기 위해 왼쪽 및 오른쪽 입력 간의 관계를 고려할 때 -1, 0 또는 1을 반환하는 두 인수의 함수를 사용할 수 있습니다. Value.Compare 사용하여 이 논리를 위임할 수 있습니다.

예를 들어 Table.Sort에 대한 설명을 참조하십시오.

개수 또는 조건 기준

이 조건은 일반적으로 순서 지정 또는 행 작업에 사용됩니다. 테이블에서 반환되는 행 수를 결정하고 숫자 또는 조건이라는 두 가지 형식을 사용할 수 있습니다.

  • 숫자는 적절한 함수를 사용하여 인라인으로 반환할 값의 수를 나타냅니다.

  • 조건을 지정하면 처음에 조건을 충족하는 값이 포함된 행이 반환됩니다. 값이 조건에 실패하면 더 이상 값이 고려되지 않습니다.

추가 정보: Table.FirstN, Table.MaxN

추가 값 처리

추가 값은 함수가 행의 추가 값을 처리하는 방법을 나타내는 데 사용됩니다. 이 매개 변수는 다음 옵션에 매핑되는 숫자로 지정됩니다.

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

추가 정보: Table.FromList, ExtraValues.Type

열 처리 누락

이 매개 변수는 함수가 누락된 열을 처리하는 방법을 나타내는 데 사용됩니다. 이 매개 변수는 다음 옵션에 매핑되는 숫자로 지정됩니다.

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

이 매개 변수는 열 또는 변환 작업(예: Table.TransformColumns)에서 사용됩니다. 추가 정보: MissingField.Type

정렬 순서

정렬 순서는 결과를 정렬하는 방법을 나타내는 데 사용됩니다. 이 매개 변수는 다음 옵션에 매핑되는 숫자로 지정됩니다.

Order.Ascending = 0 Order.Descending = 1

추가 정보: Order.Type

수식 조건

테이블에 대한 수식 조건을 다음 중 하나로 지정할 수 있습니다.

  • 다음 중 하나인 함수 값입니다.

    • 같음 조건을 적용하기 위해 테이블의 열을 결정하는 키 선택기입니다.

    • 적용할 비교 종류를 지정하는 데 사용되는 비교자 함수입니다. 기본 제공 비교자 함수를 지정할 수 있습니다. 추가 정보: Comparer 함수

  • 같음 조건을 적용할 테이블의 열 목록입니다.

예시를 보려면 Table.Distinct설명으로 이동하세요.