Text/CSV

요약

항목 설명
릴리스 상태 일반 공급
제품 Excel
Power BI(의미 체계 모델)
Power BI(데이터 흐름)
패브릭(데이터 흐름 Gen2)
Power Apps(데이터 흐름)
Dynamics 365 Customer Insights
Analysis Services
함수 참조 설명서 File.Contents
Lines.FromBinary
Csv.Document

참고 항목

일부 기능은 한 제품에 있을 수 있지만 배포 일정 및 호스트별 기능으로 인해 다른 기능은 없을 수 있습니다.

지원되는 기능

  • 가져오기

파워 쿼리 데스크톱에서 로컬 텍스트/CSV 파일로 커넥트

로컬 텍스트 또는 CSV 파일을 로드하려면 다음을 수행합니다.

  1. 데이터 가져오기에서 텍스트/CSV 옵션을 선택합니다. 이 작업은 텍스트 파일을 선택할 수 있는 로컬 파일 브라우저를 시작합니다.

    텍스트 파일 선택

    열기를 선택하여 파일을 엽니다.

  2. 탐색기에서 데이터 변환을 선택하여 Power Query 편집기 데이터를 변환하거나 로드선택하여 데이터를 로드할 수 있습니다.

    탐색기에서 텍스트입니다.

파워 쿼리 Online에서 텍스트/CSV 파일로 커넥트

로컬 텍스트 또는 CSV 파일을 로드하려면 다음을 수행합니다.

  1. 데이터 원본 페이지에서 텍스트/CSV를 선택합니다.

  2. 커넥트 설정에서 원하는 로컬 텍스트 또는 CSV 파일의 파일 경로를 입력합니다.

    온라인 텍스트 파일 선택.

  3. 데이터 게이트웨이에서 온-프레미스 데이터 게이트웨이선택합니다.

  4. 사용자 이름 및 암호 입력.

  5. 다음을 선택합니다.

  6. 탐색기에서 데이터 변환을 선택하여 Power Query 편집기 데이터 변환을 시작합니다.

    데이터를 변환합니다.

웹에서 로드

웹에서 텍스트 또는 CSV 파일을 로드하려면 웹 커넥터선택하고, 파일의 웹 주소를 입력하고, 자격 증명 프롬프트를 따릅니다.

텍스트/CSV 구분 기호

파워 쿼리는 CSV를 쉼표가 있는 구조화된 파일(텍스트 파일의 특수한 경우)으로 처리합니다. 텍스트 파일을 선택하면 파워 쿼리에서 구분 기호로 구분된 값이 있는지와 구분 기호가 무엇인지 자동으로 확인합니다. 구분 기호를 유추할 수 있는 경우 자동으로 구조화된 데이터 원본으로 처리됩니다.

구조화되지 않은 텍스트

텍스트 파일에 구조가 없으면 원본 텍스트에 인코딩된 줄당 새 행이 있는 단일 열이 표시됩니다. 구조화되지 않은 텍스트에 대한 샘플로 다음 내용이 포함된 메모장 파일을 고려할 수 있습니다.

Hello world.
This is sample data.

로드하면 이러한 각 줄을 자신의 행에 로드하는 탐색 화면이 표시됩니다.

간단한 구조화되지 않은 텍스트 파일에서 데이터를 로드합니다.

이 대화 상자에서 구성할 수 있는 것은 파일 원본 드롭다운 선택입니다. 이 드롭다운을 사용하면 파일을 생성하는 데 사용된 문자 집합을 선택할 수 있습니다. 현재 문자 집합은 유추되지 않으며 UTF-8 BOM으로 시작하는 경우에만 UTF-8이 유추됩니다.

텍스트/CSV에 대한 파일 문화권 선택

CSV

샘플 CSV 파일 은 여기에서 찾을 수 있습니다.

CSV는 파일 원본 외에도 구분 기호 지정 및 데이터 형식 검색 처리 방법도 지원합니다.

csv 파일에서 데이터 로드

사용할 수 있는 구분 기호에는 콜론, 쉼표, 등호, 세미콜론, 공간, 탭, 사용자 지정 구분 기호(모든 문자열일 수 있음) 및 고정 너비(텍스트를 일부 표준 문자 수로 분할)가 포함됩니다.

csv 파일에 대한 구분 기호 선택

마지막 드롭다운을 사용하면 데이터 형식 검색을 처리할 방법을 선택할 수 있습니다. 전체 데이터 집합에서 처음 200개 행을 기반으로 수행하거나 자동 데이터 형식 검색을 수행하지 않고 대신 모든 열을 기본값으로 '텍스트'로 설정하도록 선택할 수 있습니다. 경고: 전체 데이터 집합에서 수행하면 편집기에서 데이터의 초기 로드 속도가 느려질 수 있습니다.

csv 파일에 대한 데이터 형식 유추 선택

유추가 올바르지 않을 수 있으므로 로드하기 전에 설정을 두 번 검사 가치가 있습니다.

Structured Text

파워 쿼리가 텍스트 파일의 구조를 검색할 수 있는 경우 텍스트 파일을 구분 기호로 구분된 값 파일로 처리하고, CSV를 열 때 사용할 수 있는 동일한 옵션을 제공합니다. 이는 기본적으로 구분 기호 형식을 나타내는 확장명과 파일일 뿐입니다.

예를 들어 다음 예제를 텍스트 파일로 저장하면 구조화되지 않은 텍스트가 아닌 탭 구분 기호가 있는 것으로 읽습니다.

Column 1	Column 2	Column 3
This is a string.	1	ABC123
This is also a string.	2	DEF456

구조화된 텍스트 파일에서 데이터 로드

다른 구분 기호 기반 파일의 모든 종류에 사용할 수 있습니다.

원본 편집

원본 단계를 편집할 때 처음 로드할 때와 약간 다른 대화 상자가 표시됩니다. 현재 파일을 처리 중인 항목(즉, 텍스트 또는 csv)에 따라 다양한 드롭다운이 있는 화면이 표시됩니다.

CSV 파일에 액세스하는 쿼리의 원본 단계 편집

줄 바꿈 드롭다운을 사용하면 따옴표 안에 있는 줄 바꿈을 적용할지 여부를 선택할 수 있습니다.

CSV 파일의 줄 바꿈 스타일 편집

예를 들어 위에 제공된 '구조적' 샘플을 편집하는 경우 줄 바꿈을 추가할 수 있습니다.

Column 1	Column 2	Column 3
This is a string.	1	"ABC
123"
This is also a string.	2	"DEF456"

줄 바꿈을 따옴표로 묶은 줄 바꿈 무시로 설정하면 줄 바꿈이 없는 것처럼 로드됩니다(추가 공백 포함).

따옴표로 묶인 줄 바꿈이 무시된 CSV 파일 로드

줄 바꿈이 모든 줄 바꿈을 적용하도록 설정된 경우 줄 바꿈 후의 콘텐츠가 해당 행의 유일한 콘텐츠(정확한 출력은 파일 내용의 구조에 따라 달라질 수 있음)와 함께 추가 행을 로드합니다.

따옴표 붙은 줄 바꿈이 적용된 CSV 파일 로드

파일을 드롭다운으로 열면 문제를 해결하는 데 중요한 파일로 로드할 항목을 편집할 수 있습니다. 기술적으로 CSV가 아닌 구조화된 파일의 경우(예: 텍스트 파일로 저장된 탭으로 구분된 값 파일) CSV로 설정된 Open 파일이 있어야 합니다. 이 설정은 대화의 나머지 부분에 사용할 수 있는 드롭다운도 결정합니다.

파일 형식 변경

예제별 Text/CSV

파워 쿼리의 텍스트/CSV 예제 는 Power BI Desktop 및 파워 쿼리 Online에서 일반적으로 사용할 수 있는 기능입니다. Text/CSV 커넥터를 사용하는 경우 탐색기의 왼쪽 아래 모서리에 예제를 사용하여 표를 추출하는 옵션이 표시됩니다.

예제를 사용하여 테이블 추출 옵션 사용

이 단추를 선택하면 예제를 사용하여 테이블 추출 페이지로 이동 됩니다 . 이 페이지에서는 Text/CSV 파일에서 추출하려는 데이터에 대한 샘플 출력 값을 지정합니다. 열의 첫 번째 셀을 입력하면 열의 다른 셀이 채워집니다. 데이터를 올바르게 추출하려면 열에 둘 이상의 셀을 입력해야 할 수 있습니다. 열의 일부 셀이 잘못된 경우 첫 번째 잘못된 셀을 수정하면 데이터가 다시 추출됩니다. 처음 몇 셀의 데이터를 확인하여 데이터가 성공적으로 추출되었는지 확인합니다.

참고 항목

예제를 열 순서대로 입력하는 것이 좋습니다. 열이 성공적으로 채워지면 새 열을 만들고 새 열에 예제를 입력하기 시작합니다.

데이터를 추출할 샘플 출력 값을 지정합니다.

해당 테이블 생성이 완료되면 데이터를 로드하거나 변환하도록 선택할 수 있습니다. 결과 쿼리에 데이터 추출을 위해 유추된 모든 단계에 대한 자세한 분석이 포함된 방법을 확인합니다. 이러한 단계는 필요에 따라 사용자 지정할 수 있는 일반 쿼리 단계일 뿐입니다.

데이터 추출에 대한 단계의 자세한 분석입니다.

문제 해결

웹에서 파일 로드

웹에서 텍스트/csv 파일을 요청하고 헤더를 승격하는 경우 잠재적인 제한과 관련된 충분한 파일을 검색하는 경우 통화를 Binary.Buffer()래핑 Web.Contents 하는 것이 좋습니다. 이 경우 헤더를 승격하기 전에 파일을 버퍼링하면 파일이 한 번만 요청됩니다.

대용량 CSV 파일 작업

파워 쿼리 온라인 편집기에서 대용량 CSV 파일을 처리하는 경우 내부 오류가 발생할 수 있습니다. 먼저 더 작은 크기의 CSV 파일로 작업하고, 편집기에서 단계를 적용하고, 완료되면 더 큰 CSV 파일의 경로를 변경하는 것이 좋습니다. 이 방법을 사용하면 보다 효율적으로 작업할 수 있으며 온라인 편집기에서 시간 제한이 발생할 가능성을 줄일 수 있습니다. 더 긴 시간 제한 기간을 허용하므로 새로 고침 시간 동안 이 오류가 발생하지 않을 것으로 예상됩니다.

구조화된 텍스트로 해석되는 구조화되지 않은 텍스트

드물게 단락에서 쉼표 번호가 비슷한 문서는 CSV로 해석될 수 있습니다. 이 문제가 발생하면 파워 쿼리 편집기에서 원본 단계를 편집하고 파일 열기 드롭다운에서 CSV 대신 텍스트를 선택합니다.

Power BI Desktop의 열

CSV 파일을 가져올 때 Power BI Desktop은 Power Query 편집기 단계로 columns=x(x는 초기 가져오기 중 CSV 파일의 열 수)를 생성합니다. 나중에 더 많은 열을 추가하고 데이터 원본을 새로 고치도록 설정한 경우에는 열의 처음 x 개수를 초과하는 열은 새로 고쳐지지 않습니다.

오류: 호스트에 의해 닫힌 커넥트ion

웹 원본에서 Text/CSV 파일을 로드하고 헤더를 승격하는 경우 다음과 같은 오류가 발생할 수 있습니다. 또는 "Received an unexpected EOF or 0 bytes from the transport stream." 이러한 오류 "An existing connection was forcibly closed by the remote host" 는 호스트가 보호 조치를 사용하고 일시적으로 일시 중지될 수 있는 연결을 닫아서 발생할 수 있습니다(예: 조인 또는 추가 작업을 위해 다른 데이터 원본 연결을 기다리는 경우). 이러한 오류를 해결하려면 Binary.Buffer(권장) 또는 Table.Buffer 호출을 추가하여 파일을 다운로드하고 메모리에 로드한 다음 연결을 즉시 닫습니다. 이렇게 하면 다운로드하는 동안 일시 중지를 방지하고 콘텐츠를 검색하기 전에 호스트가 강제로 연결을 닫지 않도록 해야 합니다.

다음 예제에서는 이 해결 방법을 보여 줍니다. 결과 테이블이 Table.PromoteHeaders에 전달되기 전에 이 버퍼링을 수행해야 합니다.

  • 원본:
Csv.Document(Web.Contents("https://.../MyFile.csv"))
  • Binary.Buffer 사용:
Csv.Document(Binary.Buffer(Web.Contents("https://.../MyFile.csv")))
  • Table.Buffer 사용:
Table.Buffer(Csv.Document(Web.Contents("https://.../MyFile.csv")))