Rest API 커넥터는 데이터를 평탄화된 JSON 형식으로 변환합니다. 구체적으로, 이 커넥터는 모든 중첩된 데이터를 단일 테이블의 키 쌍 레이어로 평탄화합니다.
참고

최대 JSON 결과는 10MB이며, 데이터는 1,000열을 초과할 수 없습니다.

새 연결 설정

Minitab Connect에서 연결을 설정하려면 다음 단계를 완료하세요.
  1. 화면 추가 에서 .
  2. 데이터 Rest API 를 입력하고 결과에서 커넥터를 선택하세요.
  3. 연결을 식별하는 a 이름 를 입력합니다.
  4. 변수최대 15개의 키-값 쌍을 입력하여 값을 저장하고 재사용합니다. 첫 번째 칸에 키를 입력하고, 두 번째 칸에 값을 입력하세요. 키네임은 100자로 제한되며, 문자, 숫자, 하이픈(-), 밑줄(_)만 포함할 수 있습니다. 커넥터는 왼쪽 괄호로 시작해 오른쪽 괄호로 끝나는 값을 SQL 문으로 검증하고 실행합니다.

    값을 변수로 저장하면 여러 번 참조할 수 있고 한 곳에서만 업데이트하면 됩니다. 예를 들어, 같은 URL이 여러 번 요청되었지만 URL이 바뀔 수 있다면, 키로 base_url 를 입력하세요. 그 다음 www.example.com 를 값으로 입력하고 {{base_url}} 를 사용해 요청 내 변수를 참조하세요. URL이 변경되면 base_url 값을 변경하여 같은 연결을 통해 모든 요청에 걸쳐 새 URL을 자동으로 업데이트할 수 있습니다.

  5. 인증에서 다음 옵션 중 하나를 선택합니다.
    기본 인증
    RESTful 웹 서비스 자격증명을 입력하세요.
    API 키/토큰
    API 키와 값을 입력하세요. 원하는 인증 매개 변수 유형 선택 헤더 매개변수 하시면 GET 및 POST 요청을 할 수 있습니다. 선택 본문 매개변수 하면 POST 요청만 할 수 있습니다.
    베어러 토큰
    토큰을 입력합니다.
    JWT 토큰
    JWT 토큰을 생성하도록 선택하여 요청에 추가하세요. 원하는 인증 매개 변수 유형 선택 헤더 매개변수 하시면 GET 및 POST 요청을 할 수 있습니다. 선택 본문 매개변수 하면 POST 요청만 할 수 있습니다.
    에서 알고리즘 HS, RS 또는 ES 중 하나를 선택하세요. HS를 선택하면 알고리즘과 함께 사용할 a 비밀 를 입력하세요. RS나 ES를 선택하면 Connect가 저장 후 아이콘을 JWT 공개 키 생성합니다.
    OAuth 2.0
    OAuth 2.0으로 데이터를 접근하려면 선택하세요. 이 인증 방식의 옵션에 대한 자세한 내용은 'OAuth 2.0으로 새 연결 설정 섹션' 섹션을 참고하세요.
    없음
    웹 서비스가 사용자 이름과 비밀번호, 또는 API 키가 필요 없는지 선택하세요
  6. 고르다 저장.

연결을 저장한 후, Connect는 데이터를 새 테이블로 가져오는 옵션을 보여줍니다. '연결 데이터로 테이블 생성 섹션의 4단계부터 시작하세요. 데이터 가져오기 방법에 대해 더 알아보세요.

OAuth 2.0과 새 연결을 설정하세요

Minitab 인증 방법으로 연결을 OAuth 2.0 설정하려면 다음 단계를 완료하세요. OAuth 2.0으로 데이터에 접근하려면 보통 Connect와 API 간에 몇 차례 요청을 주고받습니다.
  1. 화면 추가 에서 .
  2. 데이터 Rest API 를 입력하고 결과에서 커넥터를 선택하세요.
  3. 연결을 식별하는 a 이름 를 입력합니다.
  4. 인증에서 OAuth 2.0을 선택합니다.
  5. 원하는 인증 매개 변수 유형 선택 헤더 매개변수 하시면 GET 및 POST 요청을 할 수 있습니다. 선택 본문 매개변수 하면 POST 요청만 할 수 있습니다.
  6. 권한 부여 유형에서 다음 옵션 중 하나를 선택합니다.
    인증 코드
    API 서비스 제공자와 인증하도록 선택하세요. 인증 코드는 클라이언트 앱으로 전송되어 추출된 후 공급자와 교환하여 향후 요청을 인증하는 액세스 토큰을 받습니다.
    암시적
    추가 인증 코드 단계 없이 액세스 토큰을 반환하도록 선택하세요. 이로 인해 보안이 떨어집니다.
    비밀번호 자격 증명
    클라이언트에서 직접 사용자 이름과 비밀번호를 전송하도록 선택하세요. 이 보조금 유형을 선택하면 API 제공자에 대해 AND 비밀번호 를 입력 사용자 이름 해야 합니다.
    클라이언트 자격 증명
    클라이언트 애플리케이션과 관련된 데이터에 접근하기 위해 사용하세요.
  7. 다음은 새로운 접근 토큰을 요청할 수 있는 전체 옵션 목록입니다. 보조금 유형에 따라 다릅니다.
    콜백 URL
    이 URL은 애플리케이션의 등록된 콜백 URL에 반드시 추가해야 합니다.
    인증 URL
    인증 코드를 받기 위해 사용하려는 인증 서버의 엔드포인트를 입력하세요. 서비스가 요구하는 비표준 매개변수를 포함하세요.
    액세스 토큰 URL
    접근 토큰을 받기 위해 사용하려는 인증 서버의 엔드포인트를 입력하세요.
    리프레시 토큰 URL
    접근 토큰 액세스 토큰 URL을 새로고침할 수 있는 권한 서버의 엔드포인트를 입력하세요.
    클라이언트 ID
    API 제공자에 등록한 클라이언트 애플리케이션의 ID입니다.
    클라이언트 암호
    API 제공자에 등록할 때 받은 클라이언트 비밀입니다.
    범위
    접근 요청의 범위에 대해 말이죠. 여러 개의 스코프를 띄우고 분리하세요.
    클라이언트 인증
    액세스 토큰을 요청할 때 클라이언트 자격 증명을 어떻게 전송할지 선택하세요.
  8. 만약 보 암시적 조금 유형으로 선택 인증 코드 하셨다면, 연결을 저장하기 전에 반드시 선택 인증하려면 클릭 해야 합니다.
  9. 고르다 저장.

연결을 저장한 후, Connect는 데이터를 새 테이블로 가져오는 옵션을 보여줍니다. 다음 섹션의 4단계부터 시작하여 데이터를 가져오는 방법에 대해 자세히 알아보세요.

연결에서 데이터를 가진 테이블을 만듭니다

API에서 데이터 파일을 가져오고 Connect에서 새 테이블을 생성하는 다음 단계를 완료하세요. 입력 박스에서 변수를 사용하면 그 변수 위에 마우스를 올려 값을 볼 수 있습니다. 하지만 테이블 설정 내에서만 변수를 참조할 수 있고, 연결 내에서는 참조할 수 없습니다. 변수를 정의하고 연결을 저장해서 변수를 참조해야 합니다. 자세한 내용은 "새 연결 설정 섹션"의 4단계를 참조하세요.
  1. 화면 추가 에서 .
  2. 데이터 Rest API 를 입력하고 결과에서 커넥터를 선택하세요.
  3. 그 아래에서 연결이전에 설정한 Rest API 연결을 선택하세요. 이전에 연결을 설정하지 않았다면, 이전 섹션의 단계를 선택하고 새 연결 따라 하세요.
  4. 왼쪽 패널에 테이블을 식별하는 a 이름 를 입력하고 a 폴더 를 선택해 테이블을 저장하세요.
  5. Connect가 테이블을 얼마나 자주 업데이트할지 , 그 아래에서 업데이트 빈도Connect가 얼마나 자주 테이블을 업데이트할지 지정합니다. 데이터를 한 번에 가져올 수도 있고, Connect가 정해진 시간 간격으로 계속 데이터를 가져올 수도 있습니다. Connect는 자동으로 가져오기 플로우를 생성합니다. 를 선택하면 한 번나중에 플로우를 사용해 자동으로 다시 가져오기를 실행할 수 있습니다.
  6. 그 아래에 URL기본 요청 URL을 입력하세요. 나중에 매개변수를 추가할 거예요.
  7. 에서 요청 유형HTTP GET 요청 또는 HTTP POST 요청을 선택합니다.
  8. 에서 최대 배열 깊이Connect가 JSON 데이터 노드를 테이블 컬럼으로 변환하는 최대 깊이를 선택합니다. Connect가 최대 깊이에 도달하면 JSON 문자열 데이터가 셀 값 결과가 됩니다. 기본적으로 최대 배열 깊이는 5입니다.
  9. 선택 다음.
  10. 요청 본문 매개변수요청 헤더 매개변수 보내고 싶은 요청 매개변수를 입력합니다. 변수를 사용하면 변수 위에 마우스를 올리면 URL의 엔드포인트를 볼 수 있습니다.
  11. 초기에는 필드가 없습니다. 요청 URL 매개변수에 키 쌍을 추가하도록 선택 매개변수 추가 하세요.
  12. 레코드용 배열 키(루트 경로)노드로 가는 쉼표 구분 경로를 입력합니다.
  13. 페이징 변수를 추가하도록 선택 응답이 여러 페이지에 걸쳐 레코드를 분리합니다 하세요. 그 다음, 에서 페이징 변수 구성다음 옵션 중 하나를 선택하세요. 어느 쪽이든 최대 100페이지까지 해석할 수 있습니다.
    다음 페이지 링크 매개변수
    이전 API 응답에서 이어서 한 페이지씩 결과를 넘기면 됩니다. 페이지 매개변수 이름 은 쉼표로 구분된 키 목록이어야 합니다. 이 키들은 답변의 다음 페이지 링크를 찾을 수 있습니다. 예를 들어, "info, next"가 있습니다.
    페이지 매개변수 및 시작 페이지 번호
    알려진 페이지 번호에 직접 접근하고 싶을 때 사용하세요. 그 다음 .을 입력합니다. 페이징 변수
  14. 고르다 저장. 도구에 준비 들어가서 선택하면요 실행, Minitab Connect가 가져온 데이터를 표시합니다.
    참고

    선택 실행후 데이터가 나타나지 않으면 선택을 선택하세요 구성 재설정.

가져오기를 저장하면 Connect가 선택한 설정으로 플로우를 생성합니다. 플로우를 스케줄링하고 데이터를 정리하기 위해 더 많은 데이터 프로세스를 추가하는 방법에 대한 자세한 정보는 다음을 참조하세요 도구 개요 흐름.

JSON 평탄화 논리

Connect는 JSON 결과를 테이블로 제대로 표현하기 위해 평평하게 조정합니다. 플랫텐딩은 JSON을 단일 계층 구조로 묶어 자식이나 부모 객체가 없는 것을 의미합니다. 모든 것이 키-값 쌍이기 때문에 열을 표현할 수 있습니다. 중첩된 객체는 열 이름에 있는 닷 연산자로 표시됩니다.