PowerApps에서 AddColumns, DropColumns, RenameColumns 및 ShowColumns 함수AddColumns, DropColumns, RenameColumns, and ShowColumns functions in PowerApps

해당 을 추가, 삭제, 이름 바꾸기 및 선택하여 테이블을 셰이프합니다.Shapes a table by adding, dropping, renaming, and selecting its columns.

개요Overview

이러한 함수는 해당 열을 조정하여 테이블을 셰이프합니다.These functions shape a table by adjusting its columns:

  • Lower 또는 Abs 와 같은 단일 열 함수를 사용하도록 여러 열을 포함하는 테이블을 단일 열로 축소시킵니다.Reduce a table that contains multiple columns down to a single column for use with single-column functions, such as Lower or Abs.
  • 테이블에 계산된 열을 추가합니다(예: QuantityUnit Price를 곱한 결과를 표시하는 Total Price 열).Add a calculated column to a table (for example, a Total Price column that shows the results of multiplying Quantity by Unit Price).
  • 사용자에게 표시하거나 수식에서 사용할 수 있도록 열의 이름을 더 의미 있게 변경합니다.Rename a column to something more meaningful, for display to users or for use in formulas.

테이블은 문자열이나 숫자처럼 PowerApps의 값입니다.A table is a value in PowerApps, just like a string or a number. 테이블을 수식의 인수로 지정할 수 있으며 함수는 테이블을 결과로 반환할 수 있습니다.You can specify a table as an argument in a formula, and functions can return a table as a result. 이 토픽에서 설명하는 함수는 테이블을 수정하지 않습니다.The functions that this topic describes don't modify a table. 대신 테이블을 인수로 사용하며 적용되는 변환을 통해 새 테이블을 반환합니다.Instead they take a table as an argument and return a new table with a transform applied. 자세한 내용은 테이블 작업을 참조하세요.See working with tables for more details.

이러한 함수를 사용하여 데이터 원본의 열을 수정할 수는 없습니다.You can't modify the columns of a data source by using these functions. 데이터는 해당 원본에서 수정해야 합니다.You must modify the data at its source. Collect 함수를 사용하여 열을 컬렉션에 추가할 수 있습니다.You can add columns to a collection with the Collect function. 자세한 내용은 데이터 원본 작업을 참조하세요.See working with data sources for more details.

설명Description

AddColumns 함수는 열을 테이블에 추가하고, 수식은 해당 열의 값을 정의합니다.The AddColumns function adds a column to a table, and a formula defines the values in that column. 기존 열은 수정되지 않고 유지됩니다.Existing columns remain unmodified.

수식은 각 테이블의 레코드에 대해 평가됩니다.The formula is evaluated for each record of the table.

현재 처리 중인 레코드의 필드는 수식 안에서 사용할 수 있습니다.Fields of the record currently being processed are available within the formula. 다른 값과 마찬가지로 이름으로 간단하게 참조합니다.You simply reference them by name as you would any other value. 또한 앱 전체에서 다른 값과 컨트롤 속성을 참조할 수도 있습니다.You can also reference control properties and other values from throughout your app. 자세한 내용은 아래 예제와 레코드 범위 작업을 참조하세요.For more details, see the examples below and working with record scope.

DropColumns 함수는 테이블에서 열을 제외합니다.The DropColumns function excludes columns from a table. 다른 모든 열은 수정되지 않고 유지됩니다.All other columns remain unmodified. DropColumns는 열을 제외하고 ShowColumns는 열을 포함합니다.DropColumns excludes columns, and ShowColumns includes columns.

RenameColumns 함수는 테이블 열의 이름을 변경합니다.The RenameColumns function renames columns of a table. 다른 모든 열은 원래 이름을 유지합니다.All other columns retain their original names.

ShowColumns 함수는 테이블의 열을 포함하고 다른 모든 열을 삭제합니다.The ShowColumns function includes columns of a table and drops all other columns. ShowColumns를 사용하여 다중 열 테이블에서 단일 열 테이블을 만들 수 있습니다.You can use ShowColumns to create a single-column table from a multi-column table. ShowColumns는 열을 포함하고 DropColumns는 열을 제외합니다.ShowColumns includes columns, and DropColumns excludes columns.

이러한 모든 함수의 경우 적용된 변환을 사용하는 새 테이블이 만들어집니다.For all these functions, the result is a new table with the transform applied. 원래 테이블은 수정되지 않습니다.The original table isn't modified.

데이터 원본에 사용할 때 이 함수는 위임할 수 없습니다.When used with a data source, these functions can't be delegated. 데이터 원본의 첫 번째 부분만 검색된 다음 함수가 적용됩니다.Only the first portion of the data source will be retrieved and then the function applied. 결과가 전체 상황을 나타내지 못할 수 있습니다.The result may not represent the complete story. 해당하는 경우 이러한 제한 사항을 상기시키고 위임 가능한 대안으로 전환하도록 제안하기 위해 수식 작성 시 경고가 표시됩니다.A warning will appear at authoring time to remind you of this limitation and to suggest switching to delegable alternatives where possible. 자세한 내용은 위임 개요를 참조하세요.For more information, see the delegation overview.

구문Syntax

AddColumns( Table, ColumnName1, Formula1 [, ColumnName2, Formula2, ... ] )AddColumns( Table, ColumnName1, Formula1 [, ColumnName2, Formula2, ... ] )

  • Table - 필수 항목입니다.Table - Required. 연산을 수행할 테이블입니다.Table to operate on.
  • ColumnName(s) - 필수 항목입니다.ColumnName(s) - Required. 추가할 열의 이름입니다.Name(s) of the column(s) to add. 이 인수에 대해 문자열(예를 들어 큰따옴표가 포함된 “Name”)을 지정해야 합니다.You must specify a string (for example, "Name" with double quotes included) for this argument.
  • Formula(s) - 필수 항목입니다.Formula(s) - Required. 각 레코드에 대해 평가할 수식입니다.Formula(s) to evaluate for each record. 결과는 해당하는 새 열 값으로 추가됩니다.The result is added as the value of the corresponding new column. 이 수식에서 테이블의 다른 열을 참조할 수 있습니다.You can reference other columns of the table in this formula.

DropColumns( Table, ColumnName1 [, ColumnName2, ... ] )DropColumns( Table, ColumnName1 [, ColumnName2, ... ] )

  • Table - 필수 항목입니다.Table - Required. 연산을 수행할 테이블입니다.Table to operate on.
  • ColumnName(s) - 필수 항목입니다.ColumnName(s) - Required. 삭제할 열의 이름입니다.Name(s) of the column(s) to drop. 이 인수에 대해 문자열(예를 들어 큰따옴표가 포함된 “Name”)을 지정해야 합니다.You must specify a string (for example, "Name" with double quotes included) for this argument.

RenameColumns( Table, OldColumneName, NewColumnName )RenameColumns( Table, OldColumneName, NewColumnName )

  • Table - 필수 항목입니다.Table - Required. 연산을 수행할 테이블입니다.Table to operate on.
  • OldColumnName -필수 항목입니다.OldColumnName - Required. 이름을 변경할 열의 이름입니다.Name of the column to rename. 이 이름은 문자열(예를 들어 큰따옴표가 포함된 “Name”)이어야 합니다.This name must be a string (for example "Name" with double quotes included).
  • NewColumnName - 필수 항목입니다.NewColumnName - Required. 교체 이름입니다.Replacement name. 이 인수에 대해 문자열(예를 들어 큰따옴표가 포함된 “Customer Name”)을 지정해야 합니다.You must specify a string (for example, "Customer Name" with double quotes included) for this argument.

ShowColumns( Table, ColumnName1 [, ColumnName2, ... ] )ShowColumns( Table, ColumnName1 [, ColumnName2, ... ] )

  • Table - 필수 항목입니다.Table - Required. 연산을 수행할 테이블입니다.Table to operate on.
  • ColumnName(s) - 필수 항목입니다.ColumnName(s) - Required. 포함할 열의 이름입니다.Name(s) of the column(s) to include. 이 인수에 대해 문자열(예를 들어 큰따옴표가 포함된 “Name”)을 지정해야 합니다.You must specify a string (for example, "Name" with double quotes included) for this argument.

Examples

이 섹션의 예제에서는 다음 테이블의 데이터가 포함된 IceCreamSales 데이터 원본을 사용합니다.The examples in this section use the IceCreamSales data source, which contains the data in this table:

이러한 예제는 모두 IceCreamSales 데이터 원본을 수정하지 않습니다.None of these examples modify the IceCreamSales data source. 각 함수는 데이터 원본의 값을 테이블로 변환하고 결과로 해당 값을 반환합니다.Each function transforms the value of the data source as a table and returns that value as the result.

수식Formula 설명Description 결과Result
AddColumns( IceCreamSales, “Revenue”, UnitPrice * QuantitySold )AddColumns( IceCreamSales, "Revenue", UnitPrice * QuantitySold ) Revenue 열을 결과에 추가합니다.Adds a Revenue column to the result. 각 레코드의 경우 UnitPrice * QuantitySold가 평가되고 결과가 새 열에 배치됩니다.For each record, UnitPrice * QuantitySold is evaluated, and the result is placed in the new column.
DropColumns( IceCreamSales, “UnitPrice” )DropColumns( IceCreamSales, "UnitPrice" ) UnitPrice 열을 결과에서 제외합니다.Excludes the UnitPrice column from the result. 이 함수를 사용하여 열을 제외하고 ShowColumns를 사용하여 포함합니다.Use this function to exclude columns, and use ShowColumns to include them.
ShowColumns( IceCreamSales, “Flavor” )ShowColumns( IceCreamSales, "Flavor" ) Flavor 열만 결과에 포함합니다.Includes only the Flavor column in the result. 이 함수를 사용하여 열을 포함하고 DropColumns를 사용하여 제외합니다.Use this function include columns, and use DropColumns to exclude them.
RenameColumns( IceCreamSales, “UnitPrice”, “Price”)RenameColumns( IceCreamSales, "UnitPrice", "Price") 결과에서 UnitPrice 열 이름을 변경합니다.Renames the UnitPrice colum in the result.
DropColumns(
RenameColumns(
AddColumns( IceCreamSales, “Revenue”,
UnitPrice * QuantitySold ),
“UnitPrice”, “Price” ),
“Quantity” )
DropColumns(
RenameColumns(
AddColumns( IceCreamSales, "Revenue",
UnitPrice * QuantitySold ),
"UnitPrice", "Price" ),
"Quantity" )
다음 테이블 변환을 수식의 내부부터 순서대로 수행합니다.Performs the following table transforms in order, starting from the inside of the formula:
  1. UnitPrice * Quantity의 레코드별 계산을 기반으로 Revenue 열을 추가합니다.Adds a Revenue column based on the per-record calculation of UnitPrice * Quantity.
  2. UnitPrice의 이름을 Price로 변경합니다.Renames UnitPrice to Price.
  3. Quantity 열을 제외합니다.Excludes the Quantity column.
순서는 중요합니다.Note that order is important. 예를 들어 이름이 변경된 후에는 UnitPrice로 계산할 수 없습니다.For example, we can't calculate with UnitPrice after it has been renamed.

단계별 가이드Step by step

  1. 갤러리에서 텍스트 및 이미지 표시에서 설명하는 첫 번째 하위 절차에 따라 Inventory라는 컬렉션을 가져오거나 만듭니다.Import or create a collection named Inventory as the first subprocedure in Show text and images in a gallery describes.

  2. 단추 하나를 추가하고 이 수식에 OnSelect 속성을 설정합니다.Add a button, and set its OnSelect property to this formula:

    ClearCollect(Inventory2, RenameColumns(Inventory, “ProductName”, “JacketID”))ClearCollect(Inventory2, RenameColumns(Inventory, "ProductName", "JacketID"))

  3. F5 키를 누르고 방금 만든 단추를 클릭한 다음 Esc 키를 눌러서 디자인 작업 영역으로 돌아갑니다.Press F5, select the button that you just created, and then press Esc to return to the design workspace.

  4. 파일 메뉴에서 컬렉션을 선택합니다.On the File menu, select Collections.

  5. Inventory2라는 컬렉션을 만들었음을 확인합니다.Confirm that you've created a collection, named Inventory2. 새 컬렉션은 InventoryProductName라는 열이 Inventory2JacketID로 이름이 변경된 것 외에 Inventory와 동일한 정보를 포함합니다.The new collection contains the same information as Inventory except that the column named ProductName in Inventory is named JacketID in Inventory2.