앱용 Common Data Service의 데이터 가져오기 또는 내보내기Import or export data from the Common Data Service for Apps

Excel 또는 CSV 파일에서 데이터를 대량으로 가져오고 내보내려면 업데이트된 Apps용 CDS(Common Data Service) 환경에 대해 Excel 파일에서 데이터 가져오기 및 데이터 내보내기 기능을 사용하면 됩니다.If you want the ability to bulk-import and export data from Excel or CSV files, you can use the Get Data from Excel file and Export Data features for updated Common Data Service (CDS) for Apps environments.

두 가지 방법으로 Excel 또는 csv 파일에서 엔터티로 파일을 가져올 수 있습니다.There are two ways you can import file into entity from Excel or csv file

옵션 1: 파일 템플릿을 만들고 수정하여 가져오기Option 1: Import by creating and modifying a file template

모든 엔터티에는 입력 파일에 있어야 하는 필수 필드가 있습니다.Every entity has required fields that must exist in your input file. 보다 원활한 방법은 엔터티로 데이터를 가져오기 위해 먼저 엔터티의 데이터를 내보내고 동일한 파일(데이터와 함께 수정됨)을 사용하여 템플릿을 만드는 것이 좋습니다.For a more seamless approach, we recommend that you create a template by first exporting data from entity and using the same file (modified with your data) to import data into the entity. 그러면 각 엔터티에 대한 필수 필드를 고려해야 하는 시간과 노력을 절감할 수 있습니다.This will save you time and effort from having to account for the required fields for each entity.

  1. 파일 템플릿 준비Prepare the file template

    • CSV에 대한 데이터 내보내기 아래에 설명된 단계를 수행하여 엔터티 데이터를 csv 파일로 내보내기 시작합니다.Start by exporting the entity data to csv file by following the steps outlined under Export data to CSV
    • 기본 키 또는 대체 키를 사용하여 데이터의 고유성을 보장하도록 계획을 정의합니다.Define a plan to ensure uniqueness of data by either using Primary Keys or Alternate Keys.
    • 엔터티로 데이터를 가져오기 전에 고유성을 보장하는 방법은 아래 섹션을 참조하세요Please refer to section below on how to ensure uniqueness prior to importing data into entity
  2. 데이터를 사용하여 파일 수정Modify the file with your data

    • Excel 또는 CSV 파일에서 방금 만든 템플릿으로 데이터 복사Copy data from your Excel or CSV file into the template that you just created
  3. 파일 가져오기Import the file

    • powerapps.com에서 데이터 섹션을 확장하고 왼쪽 탐색 창에서 엔터티를 클릭하거나 누릅니다.On powerapps.com, expand the Data section and click or tap Entities in the left navigation pane
    • 데이터를 가져가려는 엔터티를 선택합니다.Select the entity that you want to import data into
    • 맨 위에서 줄임표 또는 메뉴를 클릭하고, 데이터 가져오기를 선택하고, Excel에서 데이터 가져오기를 클릭하거나 누릅니다.Click on the ellipsis or menu at the top and select Get Data and click or tap on Get data from Excel

참고

둘 이상의 엔터티로 데이터 가져오기 위해 맨 위에 있는 메뉴에서 데이터 가져오기를 선택하고, Excel에서 데이터 가져오기를 클릭하거나 누릅니다.For importing data into more than one entity, in the menu at the top, select Get Data and click or tap Get data from Excel. 여러 엔터티를 선택하고 다음을 누를 수 있습니다.You should be able to choose multiple entities and hit Next

계정 엔터티에 데이터를 가져오는 예제

  • 그러면 Excel 또는 CSV 파일을 통해 데이터를 가져오도록 선택할 수 있는 데이터 가져오기 화면으로 이동합니다.This gets you to the Import data screen where you can choose to import data via an Excel or CSV file
  • 업로드를 클릭하거나 누릅니다.Click or tap on Upload
  • 파일을 선택하고 프롬프트에 따라 파일을 업로드하기 시작합니다.Choose your file and follow the prompts to start uploading your file

계정 엔터티에 파일을 업로드하는 예제

  • 파일이 업로드되고 매핑 상태가 녹색이 되면 오른쪽 위 모서리에서 가져오기를 클릭합니다.After the file is uploaded and Mapping Status is green, click Import in the top right corner. 매핑하는 동안 오류가 발생하면 아래 섹션을 참조하여 매핑 오류로 이동하고 문제를 해결하세요.If you encounter errors during mapping, please refere to section below to navigate and fix the mapping errors

성공적인 매핑 상태 및 가져오기 단추 예제

  • 가져오기가 성공적으로 완료되면 전체 삽입 및 업데이트를 표시합니다.Once Import completed successfully, it will show you the total inserts and updates

삽입 및 업데이트의 수를 표시하는 성공적인 가져오기 예제

참고

Upsert(업데이트 또는 삽입) 논리를 사용하여 기존의 레코드를 업데이트하거나 새 레코드를 삽입합니다.We use the Upsert (Update or Insert) logic to either update the record if it already exists, or insert a new record.

옵션 2: 고유한 원본 파일 가져오기Option 2: Import by bringing your own source file

고급 사용자이며 앱용 Common Data Service 엔터티에 대해 지정된 엔터티의 필수 필드를 사용하는 경우 고유한 Excel 또는 CSV 원본 파일을 정의하고, 파일 가져오기 아래에서 설명한 단계에 따르면 됩니다.If you are an advanced user and well versed with the required fields for a given entity for Common Data service for Apps entity, you can define your own Excel or CSV source file and follow the steps documented under Import the file

파일을 업로드한 후에 매핑 오류가 발생하는 경우 상태 매핑을 클릭하고 다음 단계를 사용하여 필드 매핑 오류를 검사하고 수정합니다.If you encounter mapping errors, after uploading your file, click on Map status, use the following steps to inspect and rectify the field mapping errors.

  • 오른쪽에서 드롭다운을 사용하여 표시 아래에서 매핑되지 않은 필드, 오류가 발생한 필드 또는 필수 필드를 설명합니다.Use the drop down on the right, under Show to walk through the Unmapped fields or Fields with error or Required Fields

경고를 수신하는지 아니면 오류를 수신하는지에 따라 필드 매핑에서 드롭다운 환경을 통해 매핑되지 않은 필드 또는 오류가 발생한 필드를 검사하기 시작합니다.Depending on whether you get a Warning or Error, start with inspecting Unmapped fields or Fields with error through the drop-down experience in Field Mappings

경고로 인해 필드 매핑과 부분 일치하는 예제

필드 매핑 문제를 탐색하는 예제

 필드 매핑에서 발생한 경고를 검사하고 수정하는 예제Example of inspecting and rectifying warnings with field mappings

  • 모든 오류 및/또는 경고를 수정하면 맨 위 오른쪽 모서리에서 변경 내용 저장을 클릭합니다. 그러면 데이터 가져오기 화면으로 이동하게 됩니다.Once you have rectified all the errors and/or warnings, click on Save Changes in the top right corner which should take you back to the Import Data screen
  • 매핑 상태 열이 완료됨을 녹색으로 나타내면 맨 위 오른쪽 모서리에서 가져오기를 클릭합니다.Once Mapping Status column indicates Completed in green, click Import in the top right corner
  • 가져오기가 성공적으로 완료됨 메시지를 수신하면 전체 삽입 및 업데이트를 표시합니다.Once you get the Import completed successfully message, it will show you the total inserts and updates

Excel 또는 CSV에서 엔터티로 데이터를 가져오는 동안 고유성 확인Ensuring uniqueness while importing data into entity from Excel or CSV

앱용 Common Data Service 엔터티는 기본 키를 사용하여 CDS 엔터티 테이블 내에 있는 레코드를 고유하게 식별합니다.Common Data Service for Apps entities use a Primary Key to uniquely identify records within a CDS entity table. CDS용 기본 키 엔터티는 GUID(전역적으로 고유한 식별자)이며 레코드 식별을 위한 기본 기초를 형성합니다.The Primary Key for a CDS entity is a Globally Unique Identifier (GUID) and form the default basis for record identification. CDS 엔터티로 데이터를 가져오는 등의 데이터 작업은 기본 키를 노출합니다.Data operations such as importing data into CDS entity will surface the default primary keys.

예제: 계정 엔터티에 대한 기본 키는 accountid입니다.Example: The Primary Key for Account entity is accountid

accountid를 기본 키로 보여주는 계정 엔터티의 샘플 내보내기 파일

경우에 따라 외부 원본에서 데이터를 통합하는 동안 기본 키는 요구 사항을 충족하지 않을 수 있습니다.Sometimes, a Primary Key may not suffice and/or meet the need while integrating data from an external source. 이를 위해 CDS를 통해 기본 키 대신 레코드를 고유하게 식별하는 대체 키를 정의할 수 있습니다.For this purpose, CDS lets you define alternate keys to uniquely identify a record in place of the primary key.

예제: 계정 엔터티에 대해 자연 키 기반 식별을 사용하여 'transactioncurrencyid'를 대체 키로 설정할 수 있습니다(예: 위에 표시된 GUID 값88c6c893-5b45-e811-a953-000d3a33bcb9 대신 '미국 달러' 사용).Example: For Account entity, you could set ‘transactioncurrencyid’ as an alternate key by using a natural key based identification (e.g. use ‘US Dollar’ instead of a GUID value 88c6c893-5b45-e811-a953-000d3a33bcb9 shown above). 통화 기호 또는 통화 이름을 키로 선택할 수도 있습니다.You can also choose currency symbol or currency name as keys.

통화 엔터티의 대체 키를 만드는 예제

통화 이름을 자연 키로 보여주는 계정 엔터티의 샘플 내보내기 파일

사용자는 대체 키를 지정한 후에 기본 키를 식별자로 사용할 수 있습니다.User can still use primary keys as identifier after specifying alternate keys. 따라서 첫 번째 파일이 여전히 유효한 위의 샘플에서 GUID는 유효한 데이터를 제공합니다.So, in the above sample first file is still valid provided GUIDs are valid data.

CSV로 데이터 내보내기Export data to CSV

표준 엔터티 또는 사용자 지정 엔터티에서 일회성으로 데이터를 내보낼 수 있으며, 한 번에 둘 이상의 엔터티에서 데이터를 내보낼 수 있습니다.You can do a one-time data export from a standard entity or custom entity, and you can export data from more than one entity at a time. 두 개 이상의 엔터티에서 데이터를 내보내는 경우 각 엔터티는 고유한 Microsoft CSV 파일로 내보냅니다.If you export data from more than one entity, each entity is exported into its own Microsoft csv file.

  1. powerapps.com에서 데이터 섹션을 확장하고 왼쪽 탐색 창에서 엔터티를 클릭하거나 누릅니다.On powerapps.com, expand the Data section and click or tap Entities in the left navigation pane

  2. 데이터를 내보내려는 엔터티를 선택합니다.Select the entity that you want to export data from

  3. 맨 위에서 줄임표 또는 메뉴를 클릭하고, 내보내기를 선택하고, 데이터를 클릭하거나 누릅니다.Click on the ellipsis or menu at the top and select Export and click or tap on Data

    계정 엔터티에서 데이터를 내보내는 예제

    참고

    여러 엔터티에서 데이터를 내보내는 경우 맨 위의 메뉴에서 내보내기를 선택하고, 데이터를 클릭하거나 누릅니다.For exporting data from multiple entities, in the menu at the top, select Export and click or tap on Data. 여러 엔터티를 선택할 수 있습니다.You should be able to choose multiple entities

  4. 내보내기 성공적으로 완료되면 다운로드할 수 있는 CSV 파일에서 관련 링크를 제공하는 내보낸 데이터를 다운로드할 수 있습니다.Once export completes successfully, you should be able to Download exported data which should you give you a link to the downloadable CSV file

    링크 다운로드 가능한 파일을 포함한 내보내기가 성공했음을 보여주는 샘플 내보내기

지원되지 않는 데이터 형식Unsupported Data Types

다음 데이터 형식은 현재 지원되지 않습니다.Following data types are currently not supported

  • 표준 시간대Timezone
  • 다중 선택 옵션 설정Multi-select option set
  • 이미지Image