Collaboration Data Clean Rooms 문제 해결하기¶

Collaboration Data Clean Rooms로 작업하는 동안 오류가 발생하면 다음 문제 해결 팁을 참조하세요.

공동 작업¶

오류:: ``GET_STATUS``에서 계정이 ``INVITED``로 표시되지만 Pending invitation for collaboration: <collaboration name> not found.
원인:: 어떤 이유로 초기 조인 시도가 실패한 경우, 이후의 조인 시도는 이러한 이유로 실패할 가능성이 높습니다.
해결책:: 협업을 삭제하고 다시 생성합니다.

오류:

자신이 생성한 공동 작업은 공동 작업자의 계정에 표시되지 않습니다.

원인:

몇 가지 가능한 이유는 다음과 같습니다.

공동 작업이 다른 클라우드 호스팅 리전에서 생성되었으며 클라우드 간 자동 복제 를 활성화하지 않았습니다.
공동 작업을 공유하지 않았거나, 잘못된 계정과 공동 작업을 공유했거나, Snowsight/SDCR UI/CLI에서 잘못된 공동 작업자 계정을 열었습니다. 공동 작업을 볼 수 있는 계정이 공동 작업을 공유한 계정인지와 해당 공유 계정에 로그인되어 있는지 확인합니다.
공동 작업을 게시한 후 공동 작업자가 볼 수 있는 시점까지는 약간의 지연이 있습니다.

해결책:

공동 작업자의 계정이 공동 작업 사양의 계정과 일치하고, 필요한 경우 클라우드 간 자동 복제가 활성화되어 있는지 확인합니다. 공동 작업이 전파될 때까지 잠시 기다립니다.

오류:

데이터 공급자가 공동 작업에 참여하려고 할 때 ReferenceUsageGrantMissingException: Reference usage grants are required for the following databases in your account ... 메시지가 표시됩니다. 이 메시지는 데이터 공급자가 공동 작업에 조인하려고 하는 경우 및 데이터 공급자의 공유 데이터에 REFERENCE_USAGE 권한이 없는 경우 표시됩니다. 이는 예상되는 동작입니다.

해결책:

오류 메시지에는 데이터베이스 이름과 공유 이름이 포함됩니다. 또는 데이터에 대한 REFERENCE_USAGE 권한이 있거나 ACCOUNTADMIN 권한이 있는 사용자는 다음 SQL 명령을 실행하여 오류 메시지에 지정된 데이터베이스 및 공유 이름을 제공해야 합니다.

GRANT REFERENCE_USAGE ON DATABASE <database_name> TO SHARE <share_name>;
REFERENCE_USAGE가 성공적으로 부여되면 데이터 공급자가 협업에 조인할 수 있습니다.

API 및 권한¶

오류:

Unknown user-defined function <function name>

원인:

DCR 협업 API에 대해 문서화된 프로시저인 경우 프로시저의 철자가 틀렸을 수 있습니다.

프로시저 이름의 철자가 틀리지 않았거나 프로시저가 시스템 프로시저인 경우(즉, 이름에 $ 포함) 이전 버전의 API를 사용 중일 수 있으며 Clean room API 버전을 업그레이드해야 할 수 있습니다.

해결책:

프로시저의 철자가 올바른지 확인하고, 그렇지 않은 경우 올바른 철자로 다시 시도하세요.
설치를 업데이트하려면 다음 SQL 코드를 실행합니다.

USE ROLE ACCOUNTADMIN;
CALL SAMOOHA_BY_SNOWFLAKE.APP_SCHEMA.PREPARE_MOUNT_SCRIPT();
EXECUTE IMMEDIATE FROM @SAMOOHA_BY_SNOWFLAKE.APP_SCHEMA.MOUNT_CODE_STAGE/dcr_loader.sql;

오류:

Issues when you create new clean rooms or run collaboration stored procedures.

원인:

If your Snowflake Data Clean Rooms installation is on version 12.3 or earlier, your API environment can be out of date with respect to the native app and automatic updates may have stopped working.

해결책:

Run the mount procedure again as ACCOUNTADMIN, verify the mount, and optionally turn automatic upgrades back on.

USE ROLE ACCOUNTADMIN;

-- Prepare the mount script
CALL SAMOOHA_BY_SNOWFLAKE.APP_SCHEMA.PREPARE_MOUNT_SCRIPT();

-- Execute the mount for Snowflake Data Clean Rooms
EXECUTE IMMEDIATE FROM @SAMOOHA_BY_SNOWFLAKE.APP_SCHEMA.MOUNT_CODE_STAGE/dcr_loader.sql;

USE ROLE SAMOOHA_APP_ROLE;
CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.LIBRARY.CHECK_MOUNT_STATUS();

-- Optional: prefer automatic upgrades in the future
CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.LIBRARY.ENABLE_LOCAL_DB_AUTO_UPGRADES();

오류:: Listing 'listing name' is not fulfilled to your current region. Please request the listing, or if already requested, retry after some time
원인:: 이전 버전의 Clean rooms API를 사용 중입니다. 이 문제는 최신 버전에서 수정되었습니다.
해결책:: Clean room 설치를 업데이트합니다.

오류:: SQL compilation error: Unknown user-defined function SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.COLLABORATION.RUN
원인:: 정규화된 프로시저 이름의 일부를 잘못 입력했거나 이 프로시저를 실행할 권한이 없습니다.
해결책:: 올바른 프로시저 이름을 사용했는지 확인합니다. SAMOOHA_APP_ROLE을 사용하지 않는 경우 해당 역할로 전환하여 동일한 오류가 발생하는지 확인합니다. 그렇지 않은 경우 이는 권한 오류입니다.

오류:

알 수 없는 사용자 정의 함수 SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.<namespace>.<procedure name>

원인:

다음 중 하나:

잘못된 네임스페이스를 사용했습니다. 적절한 COLLABORATION 또는``REGISTRY`` 네임스페이스를 호출해야 합니다.
함수 이름을 잘못 입력했습니다. 올바른 명명은 참조 가이드를 확인하세요.
프로시저를 호출할 권한이 없는 RBAC 역할을 사용 중입니다.
SAMOOHA_APP_ROLE이 없습니다.

해결책:

프로시저의 철자가 올바른지, 올바른 네임스페이스를 사용했는지 확인합니다.
SAMOOHA_APP_ROLE로 전환하여 프로시저를 실행할 수 있는지 확인합니다. 가능한 경우 현재 역할에 대한 권한이 충분하지 않은 것이 문제입니다. SAMOOHA_APP_ROLE의 사용자에게 적절한 권한 부여 를 요청합니다.
SAMOOHA_APP_ROLE이 있는지 확인하려면 다음 명령을 실행합니다.

SELECT CURRENT_USER();
SHOW GRANTS TO USER <current_user_name> ->> SELECT * FROM $1 WHERE "role" = 'SAMOOHA_APP_ROLE';

결과를 얻지 못한 경우 관리자에게 공동 작업에 대한 API 액세스를 요청합니다.

코드 번들¶

오류:: CodeSpecAlreadyExistsException
원인:: 동일한 이름과 버전의 코드 번들 사양이 이미 등록되어 있습니다.
해결책:: 다른 버전을 사용하거나 기존 버전을 업데이트합니다.

오류:: SpecValidationError
원인:: YAML이 스키마를 준수하지 않습니다.
해결책:: 필수 필드와 형식을 확인합니다.

오류:: CodeSpecStageNotAccessibleError
원인:: 아티팩트에서 참조되는 스테이지에 액세스할 수 없습니다.
해결책:: 스테이지에 대한 액세스 권한을 부여하거나 스테이지가 있는지 확인합니다.

오류:: CodeSpecArtifactNotFoundAtStageError
원인:: 지정된 스테이지 경로에서 파일을 찾을 수 없습니다.
해결책:: 등록하기 전에 스테이지에 파일을 업로드합니다.

오류:: StageDirectoryNotEnabledError
원인:: 스테이지에는 DIRECTORY가 활성화되어 있지 않습니다.
해결책:: 스테이지에서 디렉터리를 활성화합니다. ALTER STAGE ... SET DIRECTORY = (ENABLE = TRUE)

오류:: CodeSpecNotFoundForOwnerException
원인:: 템플릿이 등록되지 않은 코드 번들 사양을 참조합니다.
해결책:: 템플릿을 등록하기 전에 코드 번들 사양을 등록합니다.